summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLoïc Collignon <loic.collignon@iot.bzh>2017-03-08 12:44:50 +0100
committerRomain Forlot <romain.forlot@iot.bzh>2017-03-16 17:10:39 +0100
commit28ed18d85e2bb0ac1f5f4f7e4505eee356834537 (patch)
tree3141e073a3a3b3724a158d621b3b1c4ce0a80a03
parent2049aca0927b55f2a256fd60ff686616b73eecb7 (diff)
Change doxygen comments
Change-Id: Ia635a7483e2fcda3b98fd3d3b3f7e996d26926d0 Signed-off-by: Loïc Collignon <loic.collignon@iot.bzh>
-rw-r--r--src/can/can-bus.hpp57
-rw-r--r--src/diagnostic/active-diagnostic-request.hpp1
2 files changed, 20 insertions, 38 deletions
diff --git a/src/can/can-bus.hpp b/src/can/can-bus.hpp
index 3ae41c9..4c26528 100644
--- a/src/can/can-bus.hpp
+++ b/src/can/can-bus.hpp
@@ -126,46 +126,29 @@ class can_bus_dev_t {
int send_can_message(can_message_t& can_msg);
};
-/** TODO: implement this function as method into can_bus class
- * @fn void pre_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
- * @brief Pre initialize actions made before CAN bus initialization
- *
- * @param[in] can_bus_dev_t bus - A CanBus struct defining the bus's metadata
- * @param[in] bool 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.
- * @param[in] buses - An array of all CAN buses.
- * @param[in] int busCount - The length of the buses array.
- */
+/// TODO: implement this function as method into can_bus class
+/// @brief Pre initialize actions made before CAN bus initialization
+/// @param[in] bus A CanBus struct defining the bus's metadata
+/// @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.
+/// @param[in] buses An array of all CAN buses.
+/// @param[in] busCount The length of the buses array.
void pre_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
-/** TODO: implement this function as method into can_bus class
- * @fn void post_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
- * @brief Post-initialize actions made after CAN bus initialization
- *
- * @param[in] bus - A CanBus struct defining the bus's metadata
- * @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.
- * @param[in] buses - An array of all CAN buses.
- * @param[in] busCount - The length of the buses array.
- */
+/// TODO: implement this function as method into can_bus class
+/// @brief Post-initialize actions made after CAN bus initialization
+/// @param[in] bus A CanBus struct defining the bus's metadata
+/// @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.
+/// @param[in] buses An array of all CAN buses.
+/// @param[in] busCount The length of the buses array.
void post_initialize(can_bus_dev_t* bus, bool writable, can_bus_dev_t* buses, const int busCount);
-/** TODO: implement this function as method into can_bus class
- * @fn bool isBusActive(can_bus_dev_t* bus);
- * @brief Check if the device is connected to an active CAN bus, i.e. it's
- * received a message in the recent past.
- *
- * @return true if a message was received on the CAN bus within
- * CAN_ACTIVE_TIMEOUT_S seconds.
- */
+/// TODO: implement this function as method into can_bus class
+/// @brief Check if the device is connected to an active CAN bus, i.e. it's received a message in the recent past.
+/// @return true if a message was received on the CAN bus within CAN_ACTIVE_TIMEOUT_S seconds.
bool isBusActive(can_bus_dev_t* bus);
-/** TODO: implement this function as method into can_bus class
- *
- * @fn void logBusStatistics(can_bus_dev_t* buses, const int busCount);
- * @brief Log transfer statistics about all active CAN buses to the debug log.
- *
- * @param[in] buses - an array of active CAN buses.
- * @param[in] busCount - the length of the buses array.
- */
-void logBusStatistics(can_bus_dev_t* buses, const int busCount); \ No newline at end of file
+/// TODO: implement this function as method into can_bus class
+/// @brief Log transfer statistics about all active CAN buses to the debug log.
+/// @param[in] buses An array of active CAN buses.
+/// @param[in] busCount The length of the buses array.
+void logBusStatistics(can_bus_dev_t* buses, const int busCount);
diff --git a/src/diagnostic/active-diagnostic-request.hpp b/src/diagnostic/active-diagnostic-request.hpp
index 55b55f5..fe237d4 100644
--- a/src/diagnostic/active-diagnostic-request.hpp
+++ b/src/diagnostic/active-diagnostic-request.hpp
@@ -78,5 +78,4 @@ class active_diagnostic_request_t {
FrequencyClock timeoutClock_; /*!< FrequencyClock timeoutClock_ - A FrequencyClock struct to monitor how long it's been since
* this request was sent.*/
public:
-
};