Use of signals prefix to be able to distinguish type of
[apps/agl-service-can-low-level.git] / src / configuration.hpp
1 /*
2  * Copyright (C) 2015, 2016 "IoT.bzh"
3  * Author "Romain Forlot" <romain.forlot@iot.bzh>
4  *
5  * Licensed under the Apache License, Version 2.0 (the "License");
6  * you may not use this file except in compliance with the License.
7  * You may obtain a copy of the License at
8  *
9  *       http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  * See the License for the specific language governing permissions and
15  * limitations under the License.
16  */
17
18 #pragma once
19
20 #include <vector>
21 #include <fcntl.h>
22
23 #include "can/can-bus.hpp"
24 #include "can/can-signals.hpp"
25 #include "can/can-message.hpp"
26 #include "obd2/diagnostic-manager.hpp"
27
28 #include "low-can-binding.hpp"
29
30 /**
31  * @brief Class representing a configuration attached to the binding.
32  *
33  * @desc It regroups all needed objects instance from other class
34  *  that will be used along the binding life. It gets a global vision 
35  *  on which signals are implemented for that binding. 
36  *  Here, it is only the definition of the class with predefined accessors
37  *  methods used in the binding.
38  *
39  *  It will be the reference point to needed objects.
40  */
41 class configuration_t
42 {
43         private:
44                 can_bus_t can_bus_manager_ = can_bus_t(afb_daemon_rootdir_open_locale(binder_interface->daemon, "can_buses.json", O_RDONLY, NULL));
45                 diagnostic_manager_t diagnostic_manager_;
46                 uint8_t active_message_set_ = 0;
47                 std::vector<std::string> signals_prefix_;
48
49                 std::vector<can_message_set_t> can_message_set_;
50                 std::vector<std::vector<can_signal_t>> can_signals_;
51                 std::vector<std::vector<obd2_signal_t>> obd2_signals_;
52                 std::vector<std::vector<can_message_definition_t>> can_message_definition_;
53
54                 /// Private constructor with implementation generated by the AGL generator.
55                 configuration_t();
56
57         public:
58                 static configuration_t& instance();
59
60                 configuration_t& get_configuration() ;
61
62                 can_bus_t& get_can_bus_manager();
63
64                 diagnostic_manager_t& get_diagnostic_manager() ;
65
66                 uint8_t get_active_message_set() const;
67
68                 const std::vector<can_message_set_t>& get_can_message_set();
69
70                 std::vector<can_signal_t>& get_can_signals();
71
72                 const std::vector<can_message_definition_t>& get_can_message_definition();
73
74                 std::vector<obd2_signal_t>& get_obd2_signals();
75
76                 const std::vector<std::string>& get_signals_prefix() const;
77                 uint32_t get_signal_id(obd2_signal_t& sig) const;
78
79                 uint32_t get_signal_id(can_signal_t& sig) const;
80
81                 void set_active_message_set(uint8_t id);
82
83                 void find_obd2_signals(const openxc_DynamicField &key, std::vector<obd2_signal_t*>& found_signals);
84
85                 void find_can_signals(const openxc_DynamicField &key, std::vector<can_signal_t*>& found_signals);
86
87 /*
88                 /// TODO: implement this function as method into can_bus class
89                 /// @brief Pre initialize actions made before CAN bus initialization
90                 /// @param[in] bus A CanBus struct defining the bus's metadata
91                 /// @param[in] writable Configure the controller in a writable mode. If false, it will be configured as "listen only" and will not allow writes or even CAN ACKs.
92                 /// @param[in] buses An array of all CAN buses.
93                 /// @param[in] busCount The length of the buses array.
94                 void pre_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
95                 /// TODO: implement this function as method into can_bus class
96                 /// @brief Post-initialize actions made after CAN bus initialization
97                 /// @param[in] bus A CanBus struct defining the bus's metadata
98                 /// @param[in] writable Configure the controller in a writable mode. If false, it will be configured as "listen only" and will not allow writes or even CAN ACKs.
99                 /// @param[in] buses An array of all CAN buses.
100                 /// @param[in] busCount The length of the buses array.
101                 void post_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
102                 /// TODO: implement this function as method into can_bus class
103                 /// @brief Check if the device is connected to an active CAN bus, i.e. it's received a message in the recent past.
104                 /// @return true if a message was received on the CAN bus within CAN_ACTIVE_TIMEOUT_S seconds.
105                 void logBusStatistics(can_bus_dev_t* buses, const int busCount);
106                 /// TODO: implement this function as method into can_bus class
107                 /// @brief Log transfer statistics about all active CAN buses to the debug log.
108                 /// @param[in] buses An array of active CAN buses.
109                 /// @param[in] busCount The length of the buses array.
110                 bool isBusActive(can_bus_dev_t* bus);
111                 */
112 };