2 * Copyright (C) 2015, 2016 "IoT.bzh"
3 * Author "Romain Forlot" <romain.forlot@iot.bzh>
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
9 * http://www.apache.org/licenses/LICENSE-2.0
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.
25 #include <linux/can.h>
27 #include <condition_variable>
30 #include "openxc.pb.h"
31 #include "can-utils.hpp"
35 #include <afb/afb-binding.h>
36 #include <afb/afb-event-itf.h>
39 #define MESSAGE_SET_ID 0
42 * @brief Can signal event map making access to afb_event
43 * externaly to an openxc existing structure.
45 * @desc Event map is making relation between CanSignal generic name
46 * and the afb_event struct used by application framework to pushed
49 static std::map<std::string, struct afb_event> subscribed_signals;
52 * @brief Mutex allowing safe manipulation on subscribed_signals map.
53 * @desc To ensure that the map object isn't modified when we read it, you
54 * have to set this mutex before use subscribed_signals map object.
56 extern std::mutex subscribed_signals_mutex;
58 /** Public: Return the currently active CAN configuration. */
59 CanMessageSet* getActiveMessageSet();
61 /** Public: Retrive a list of all possible CAN configurations.
63 * Returns a pointer to an array of all configurations.
65 CanMessageSet* getMessageSets();
67 /** Public: Return the length of the array returned by getMessageSets() */
68 int getMessageSetCount();
70 /* Public: Return the number of CAN buses configured in the active
71 * configuration. This is limited to 2, as the hardware controller only has 2
76 /* Public: Return an array of all CAN messages to be processed in the active
79 CanMessageDefinition* getMessages();
81 /* Public: Return signals from an signals array filtered on name.
83 const std::vector<CanSignal> getSignals();
85 /* Public: Return an array of all OpenXC CAN commands enabled in the active
86 * configuration that can write back to CAN with a custom handler.
88 * * Commands not defined here are handled using a 1-1 mapping from the signals
91 CanCommand* getCommands();
93 /* Public: Return the length of the array returned by getCommandCount(). */
94 int getCommandCount();
96 /* Public: Return the length of the array returned by getSignals(). */
97 size_t getSignalCount();
99 /* Public: Return the length of the array returned by getMessages(). */
100 int getMessageCount();
103 * @brief Return an array of the metadata for the 2 CAN buses you want to
104 * monitor. The size of this array is fixed at 2.
106 CanBus* getCanBuses();
109 * @brief Find one or many signals based on its name or id
110 * passed through openxc_DynamicField.
112 * @param[in] openxc_DynamicField& - a const reference with the key to search into signal.
113 * Key is either a signal name or its CAN arbitration id.
115 * @return std::vector<std::string> return found CanSignal generic name vector.
117 std::vector<CanSignal> find_can_signals(const openxc_DynamicField &key);
120 * @brief Retrieve can arbitration id of a given CanSignal
122 * @param[in] CanSignal& - a const reference to a CanSignal
124 * @return uint32_t - unsigned integer representing the arbitration id.
126 inline uint32_t get_CanSignal_id(const CanSignal& sig);
129 * @brief return the subscribed_signals map.
131 * return std::map<std::string, struct afb_event> - map of subscribed signals.
133 const std::map<std::string, struct afb_event> get_subscribed_signals();