doxygen: document some more structure members for RSL

This commit is contained in:
Harald Welte 2011-08-18 11:45:18 +02:00
parent 02624d2743
commit be145198df
1 changed files with 21 additions and 14 deletions

View File

@ -33,47 +33,54 @@
/*! \brief RSL common header */ /*! \brief RSL common header */
struct abis_rsl_common_hdr { struct abis_rsl_common_hdr {
uint8_t msg_discr; uint8_t msg_discr; /*!< \brief message discriminator (ABIS_RSL_MDISC_*) */
uint8_t msg_type; uint8_t msg_type; /*!< \brief message type (\ref abis_rsl_msgtype) */
uint8_t data[0]; uint8_t data[0]; /*!< \brief actual payload data */
} __attribute__ ((packed)); } __attribute__ ((packed));
/* \brief RSL RLL header (Chapter 8.3) */ /* \brief RSL RLL header (Chapter 8.3) */
struct abis_rsl_rll_hdr { struct abis_rsl_rll_hdr {
struct abis_rsl_common_hdr c; struct abis_rsl_common_hdr c;
uint8_t ie_chan; uint8_t ie_chan; /*!< \brief \ref RSL_IE_CHAN_NR (tag) */
uint8_t chan_nr; uint8_t chan_nr; /*!< \brief RSL channel number (value) */
uint8_t ie_link_id; uint8_t ie_link_id; /*!< \brief \ref RSL_IE_LINK_IDENT (tag) */
uint8_t link_id; uint8_t link_id; /*!< \brief RSL link identifier (value) */
uint8_t data[0]; uint8_t data[0]; /*!< \brief message payload data */
} __attribute__ ((packed)); } __attribute__ ((packed));
/* \brief RSL Dedicated Channel header (Chapter 8.3 and 8.4) */ /* \brief RSL Dedicated Channel header (Chapter 8.3 and 8.4) */
struct abis_rsl_dchan_hdr { struct abis_rsl_dchan_hdr {
struct abis_rsl_common_hdr c; struct abis_rsl_common_hdr c;
uint8_t ie_chan; uint8_t ie_chan; /*!< \brief \ref RSL_IE_CHAN_NR (tag) */
uint8_t chan_nr; uint8_t chan_nr; /*!< \brief RSL channel number (value) */
uint8_t data[0]; uint8_t data[0]; /*!< \brief message payload data */
} __attribute__ ((packed)); } __attribute__ ((packed));
/* \brief RSL Common Channel header (Chapter 8.5) */ /* \brief RSL Common Channel header (Chapter 8.5) */
struct abis_rsl_cchan_hdr { struct abis_rsl_cchan_hdr {
struct abis_rsl_common_hdr c; struct abis_rsl_common_hdr c;
uint8_t ie_chan; uint8_t ie_chan; /*!< \brief \ref RSL_IE_CHAN_NR (tag) */
uint8_t chan_nr; uint8_t chan_nr; /*!< \brief RSL channel number (value) */
uint8_t data[0]; uint8_t data[0]; /*!< \brief message payload data */
} __attribute__ ((packed)); } __attribute__ ((packed));
/* Chapter 9.1 */ /* Chapter 9.1 */
/* \brief RSL Message Discriminator: RLL */
#define ABIS_RSL_MDISC_RLL 0x02 #define ABIS_RSL_MDISC_RLL 0x02
/* \brief RSL Message Discriminator: Dedicated Channel */
#define ABIS_RSL_MDISC_DED_CHAN 0x08 #define ABIS_RSL_MDISC_DED_CHAN 0x08
/* \brief RSL Message Discriminator: Common Channel */
#define ABIS_RSL_MDISC_COM_CHAN 0x0c #define ABIS_RSL_MDISC_COM_CHAN 0x0c
/* \brief RSL Message Discriminator: TRX Management */
#define ABIS_RSL_MDISC_TRX 0x10 #define ABIS_RSL_MDISC_TRX 0x10
/* \brief RSL Message Discriminator: Location Service */
#define ABIS_RSL_MDISC_LOC 0x20 #define ABIS_RSL_MDISC_LOC 0x20
/* \brief RSL Message Discriminator: ip.access */
#define ABIS_RSL_MDISC_IPACCESS 0x7e #define ABIS_RSL_MDISC_IPACCESS 0x7e
#define ABIS_RSL_MDISC_TRANSP 0x01 #define ABIS_RSL_MDISC_TRANSP 0x01
/* \brief Check if given RSL message discriminator is transparent */
#define ABIS_RSL_MDISC_IS_TRANSP(x) (x & 0x01) #define ABIS_RSL_MDISC_IS_TRANSP(x) (x & 0x01)
/* \brief RSL Message Tyoe (Chapter 9.1) */ /* \brief RSL Message Tyoe (Chapter 9.1) */