From 7913dd8af3861da4942123ab18d70d0aded921b1 Mon Sep 17 00:00:00 2001 From: Manuel Traut Date: Tue, 29 May 2012 03:24:03 +0200 Subject: added doxygen for interfaces - a brief description of all interface functions Signed-off-by: Manuel Traut --- interfaces/common.idl | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'interfaces/common.idl') diff --git a/interfaces/common.idl b/interfaces/common.idl index 7e6266c..f80b9f7 100644 --- a/interfaces/common.idl +++ b/interfaces/common.idl @@ -1,14 +1,29 @@ #ifndef DISTIO_COMMON_IDL #define DISTIO_COMMON_IDL +/** + * @brief shared between different modules + * + * - definitions for error handling + * + * @author Manuel Traut + * @copyright GPLv2 + * + */ module Common { +/** + * @brief kind of error + */ enum Error_code { SUCCESS, EINVAL, ENOTSUPPORTED }; +/** + * @brief used for filtering and classification + */ enum Error_level { DEBUG, INFO, @@ -17,16 +32,25 @@ module Common { CRITICAL }; +/** + * @brief describes when the error was detected + * (it's helpful to sync all boards with ntp) + */ struct Error_timestamp { longlong seconds; long nanoseconds; }; +/** + * @brief description of an error + */ struct Error { Error_code code; Error_level level; Error_timestamp time; + /** id of the digital/analog IO or the IO device */ long module_id; + /** a human readable description which can be displayed in GUIs */ string description; }; -- cgit v1.2.3