From 890f1f5a2cf7fbf4c12abc049ba765a39dd9cf9c Mon Sep 17 00:00:00 2001
From: Philipp Maier <pmaier@sysmocom.de>
Date: Fri, 16 Jun 2017 16:59:06 +0200
Subject: cosmetic: Add info about coresponding codecs to permitted speech
consts
The constants in enum gsm0808_permitted_speech are not very expressive.
Add comments indicating each constant's corresponding codec.
Change-Id: I9734f7c261becffe38ffd41c304d006d08530c1a
---
include/osmocom/gsm/protocol/gsm_08_08.h | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/include/osmocom/gsm/protocol/gsm_08_08.h b/include/osmocom/gsm/protocol/gsm_08_08.h
index e5e7e1ef..5916823c 100644
--- a/include/osmocom/gsm/protocol/gsm_08_08.h
+++ b/include/osmocom/gsm/protocol/gsm_08_08.h
@@ -391,14 +391,15 @@ enum gsm0808_chan_rate_type_speech {
GSM0808_SPEECH_PERM_NO_CHANGE = 0x1f,
};
-/* GSM 08.08 3.2.2.11 Channel Type */
+/*! \brief GSM 08.08 3.2.2.11 Channel Type
+ * (see also 3GPP TS 48.008, section 3.2.2.11) */
enum gsm0808_permitted_speech {
- GSM0808_PERM_FR1 = 0x01,
- GSM0808_PERM_FR2 = 0x11,
- GSM0808_PERM_FR3 = 0x21,
- GSM0808_PERM_HR1 = GSM0808_PERM_FR1 | 0x4,
- GSM0808_PERM_HR2 = GSM0808_PERM_FR2 | 0x4,
- GSM0808_PERM_HR3 = GSM0808_PERM_FR3 | 0x4,
+ GSM0808_PERM_FR1 = 0x01, /*!< GSM FR */
+ GSM0808_PERM_FR2 = 0x11, /*!< GSM EFR */
+ GSM0808_PERM_FR3 = 0x21, /*!< FR AMR */
+ GSM0808_PERM_HR1 = GSM0808_PERM_FR1 | 0x4, /*!< GSM HR */
+ GSM0808_PERM_HR2 = GSM0808_PERM_FR2 | 0x4, /*!< (deprecated) */
+ GSM0808_PERM_HR3 = GSM0808_PERM_FR3 | 0x4, /*!< HR AMR */
};
/* GSM 08.08 3.2.2.44 Chosen Encryption Algorithm */
--
cgit v1.2.3