CAN-binder/low-can-binding/can/can-message-definition.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 /**
  19  * @class can_message_definition_t
  20  *
  21  * @brief The definition of a CAN message. This includes a lot of metadata, so
  22  * to save memory this struct should not be used for storing incoming and
  23  * outgoing CAN messages.
  24  */
  25
  26 #pragma once
  27
  28 #include <vector>
  29 #include <memory>
  30
  31 #include "can-signals.hpp"
  32 #include "can-message.hpp"
  33 #include "../utils/timer.hpp"
  34
  35 class can_message_set_t;
  36
  37 class can_message_definition_t
  38 {
  39 private:
  40         std::shared_ptr<can_message_set_t> parent_; /*!< parent_ - Pointer to the CAN message set holding this CAN message definition */
  41         std::string bus_; /*!< bus_ - Address of CAN bus device. */
  42         uint32_t id_; /*!< id_ - The ID of the message.*/
  43         can_message_format_t format_; /*!< format_ - the format of the message's ID.*/
  44         frequency_clock_t frequency_clock_; /*!<  clock_ - an optional frequency clock to control the output of this
  45                                                         *      message, if sent raw, or simply to mark the max frequency for custom
  46                                                         *      handlers to retrieve.*/
  47         bool force_send_changed_; /*!< force_send_changed_ - If true, regardless of the frequency, it will send CAN
  48                                                         *       message if it has changed when using raw passthrough.*/
  49         std::vector<uint8_t> last_value_; /*!< last_value_ - The last received value of the message. Defaults to undefined.
  50                                                                                 *       This is required for the forceSendChanged functionality, as the stack
  51                                                                                 *       needs to compare an incoming CAN message with the previous frame.*/
  52         std::vector<std::shared_ptr<can_signal_t> > can_signals_; /*!< can_signals_ - Vector holding can_signal_t object which share the same arbitration ID */
  53
  54 public:
  55         //can_message_definition_t(const can_message_definition_t& b);
  56         can_message_definition_t(const std::string bus);
  57         can_message_definition_t(const std::string bus, uint32_t id, frequency_clock_t frequency_clock, bool force_send_changed);
  58         can_message_definition_t(const std::string bus, uint32_t id, can_message_format_t format, frequency_clock_t frequency_clock, bool force_send_changed);
  59         can_message_definition_t(const std::string bus, uint32_t id, can_message_format_t format, frequency_clock_t frequency_clock, bool force_send_changed, std::vector<std::shared_ptr<can_signal_t> > can_signals);
  60
  61         const std::string& get_bus_name() const;
  62         uint32_t get_id() const;
  63         std::vector<std::shared_ptr<can_signal_t> >& get_can_signals();
  64
  65         void set_parent(std::shared_ptr<can_message_set_t> parent);
  66         void set_last_value(const can_message_t& cm);
  67 };