aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorHarald Welte <laforge@gnumonks.org>2011-08-21 11:13:50 +0200
committerHarald Welte <laforge@gnumonks.org>2011-08-21 11:13:50 +0200
commit2f69b890bcc3f810be2e018f1f422246641ed5c0 (patch)
tree967870c947f19b05717f7e5fdfaf72029fade5d3 /include
parente4ec40a365d5791392f8f68eaff1af4aab9db3b4 (diff)
trau_frame: Add doxygen documentation
Diffstat (limited to 'include')
-rw-r--r--include/osmocom/abis/trau_frame.h21
1 files changed, 16 insertions, 5 deletions
diff --git a/include/osmocom/abis/trau_frame.h b/include/osmocom/abis/trau_frame.h
index 64bec2b..f2a7015 100644
--- a/include/osmocom/abis/trau_frame.h
+++ b/include/osmocom/abis/trau_frame.h
@@ -22,17 +22,26 @@
#include <stdint.h>
-/* 21 for FR/EFR, 25 for AMR, 15 for OM, 15 for data, 13 for E-data, 21 idle */
+/*! \defgroup trau_frame TRAU frame handling
+ * @{
+ *
+ * \file trau_frame.h
+ */
+
+/*! \brief Maximum number of C-bits in a TRAU frame:
+ * 21 for FR/EFR, 25 for AMR, 15 for OM, 15 for data, 13 for E-data, 21 idle */
#define MAX_C_BITS 25
-/* 260 for FR/EFR, 256 for AMR, 264 for OM, 288 for E-data */
+/*! \brief Maximum number of D-bits in a TRAU frame:
+ * 260 for FR/EFR, 256 for AMR, 264 for OM, 288 for E-data */
#define MAX_D_BITS 288
-/* for all speech frames */
+/*! \brief Maximum number of T-bits in a TRAU frame for all speech frames */
#define MAX_T_BITS 4
-/* for OM */
+/*! \brief Maximum number of S-bits in a TRAU frame for OM */
#define MAX_S_BITS 6
-/* for E-data */
+/*! \brief Maximum number of M-bits in a TRAU frame for E-data */
#define MAX_M_BITS 2
+/*! \brief a decoded TRAU frame, extracted C/D/T/S/M bits */
struct decoded_trau_frame {
uint8_t c_bits[MAX_C_BITS];
uint8_t d_bits[MAX_D_BITS];
@@ -61,4 +70,6 @@ int trau_frame_up2down(struct decoded_trau_frame *fr);
uint8_t *trau_idle_frame(void);
+/* }@ */
+
#endif /* _TRAU_FRAME_H */