]> rtime.felk.cvut.cz Git - CanFestival-3.git/blobdiff - include/unix/canfestival.h
Second time, Re-write doxygen tags in headers files to generate User API documentation
[CanFestival-3.git] / include / unix / canfestival.h
index af8e1761aa8acbd0f5c51bd004b99f499710d60d..7eb149012a41d27edc885eb93f510f7b71d575da 100644 (file)
@@ -10,15 +10,74 @@ extern "C" {
 #include "data.h"
 #include "timers_driver.h"
 
+#ifndef __KERNEL__
 #include <dlfcn.h>
+#endif
+
 typedef void* LIB_HANDLE;
 
+/** @defgroup userapi User API */
+
+/** @defgroup can CAN management
+ *  @ingroup userapi
+ */
+
+/**
+ * @ingroup can
+ * @{
+ */
+
+/**
+ * @ingroup can
+ * @brief Unload CAN driver interface
+ * @param handle The library handle
+ * @return 0 if succes
+ */
 UNS8 UnLoadCanDriver(LIB_HANDLE handle);
-LIB_HANDLE LoadCanDriver(char* driver_name);
+
+/**
+ * @ingroup can
+ * @brief Load CAN driver interface
+ * @param *driver_name The location of the library to load
+ * @return handle The library handle
+ */
+LIB_HANDLE LoadCanDriver(const char* driver_name);
+
+/**
+ * @brief Send a CAN message
+ * @param port CanFestival file descriptor
+ * @param *m The message to send
+ * @return 0 if succes
+ */
 UNS8 canSend(CAN_PORT port, Message *m);
+
+/**
+ * @ingroup can
+ * @brief Open a CANopen device
+ * @param *board Pointer on the board structure that contains busname and baudrate 
+ * @param *d Pointer on the CAN object data structure
+ * @return port CanFestival file descriptor
+ */
 CAN_PORT canOpen(s_BOARD *board, CO_Data * d);
+
+/**
+ * @ingroup can
+ * @brief Close a CANopen device
+ * @param *d Pointer on the CAN object data structure
+ * @return 0 if succes
+ */
 int canClose(CO_Data * d);
+
+/**
+ * @ingroup can
+ * @brief Change the CANopen device baudrate 
+ * @param port CanFestival file descriptor 
+ * @param *baud The new baudrate to assign
+ * @return 0 if succes
+ */
 UNS8 canChangeBaudRate(CAN_PORT port, char* baud);
+/** @} */
+
 
 #ifdef __cplusplus
 };