fixeria has uploaded this change for review. ( https://gerrit.osmocom.org/c/osmocom-bb/+/28544 )
Change subject: trxcon: remove '\brief' marker from the comments
......................................................................
trxcon: remove '\brief' marker from the comments
This marker is not required to be present in Doxygen comments.
Change-Id: If793037e2b2bc9b708617867a4d4ddb0fa2f1ddb
---
M src/host/trxcon/include/osmocom/bb/trxcon/sched_trx.h
M src/host/trxcon/include/osmocom/bb/trxcon/scheduler.h
2 files changed, 72 insertions(+), 72 deletions(-)
git pull ssh://gerrit.osmocom.org:29418/osmocom-bb refs/changes/44/28544/1
diff --git a/src/host/trxcon/include/osmocom/bb/trxcon/sched_trx.h b/src/host/trxcon/include/osmocom/bb/trxcon/sched_trx.h
index ab8ef34..ad860e9 100644
--- a/src/host/trxcon/include/osmocom/bb/trxcon/sched_trx.h
+++ b/src/host/trxcon/include/osmocom/bb/trxcon/sched_trx.h
@@ -120,63 +120,63 @@
struct sched_burst_req *br);
struct trx_lchan_desc {
- /*! \brief Human-readable name */
+ /*! Human-readable name */
const char *name;
- /*! \brief Human-readable description */
+ /*! Human-readable description */
const char *desc;
- /*! \brief Channel Number (like in RSL) */
+ /*! Channel Number (like in RSL) */
uint8_t chan_nr;
- /*! \brief Link ID (like in RSL) */
+ /*! Link ID (like in RSL) */
uint8_t link_id;
- /*! \brief Sub-slot number (for SDCCH and TCH/H) */
+ /*! Sub-slot number (for SDCCH and TCH/H) */
uint8_t ss_nr;
- /*! \brief GSMTAP channel type (see GSMTAP_CHANNEL_*) */
+ /*! GSMTAP channel type (see GSMTAP_CHANNEL_*) */
uint8_t gsmtap_chan_type;
- /*! \brief How much memory do we need to store bursts */
+ /*! How much memory do we need to store bursts */
size_t burst_buf_size;
- /*! \brief Channel specific flags */
+ /*! Channel specific flags */
uint8_t flags;
- /*! \brief Function to call when burst received from PHY */
+ /*! Function to call when burst received from PHY */
trx_lchan_rx_func *rx_fn;
- /*! \brief Function to call when data received from L2 */
+ /*! Function to call when data received from L2 */
trx_lchan_tx_func *tx_fn;
};
struct trx_frame {
- /*! \brief Downlink TRX channel type */
+ /*! Downlink TRX channel type */
enum trx_lchan_type dl_chan;
- /*! \brief Downlink block ID */
+ /*! Downlink block ID */
uint8_t dl_bid;
- /*! \brief Uplink TRX channel type */
+ /*! Uplink TRX channel type */
enum trx_lchan_type ul_chan;
- /*! \brief Uplink block ID */
+ /*! Uplink block ID */
uint8_t ul_bid;
};
struct trx_multiframe {
- /*! \brief Channel combination */
+ /*! Channel combination */
enum gsm_phys_chan_config chan_config;
- /*! \brief Human-readable name */
+ /*! Human-readable name */
const char *name;
- /*! \brief Repeats how many frames */
+ /*! Repeats how many frames */
uint8_t period;
- /*! \brief Applies to which timeslots */
+ /*! Applies to which timeslots */
uint8_t slotmask;
- /*! \brief Contains which lchans */
+ /*! Contains which lchans */
uint64_t lchan_mask;
- /*! \brief Pointer to scheduling structure */
+ /*! Pointer to scheduling structure */
const struct trx_frame *frames;
};
struct trx_meas_set {
- /*! \brief TDMA frame number of the first burst this set belongs to */
+ /*! TDMA frame number of the first burst this set belongs to */
uint32_t fn;
- /*! \brief ToA256 (Timing of Arrival, 1/256 of a symbol) */
+ /*! ToA256 (Timing of Arrival, 1/256 of a symbol) */
int16_t toa256;
- /*! \brief RSSI (Received Signal Strength Indication) */
+ /*! RSSI (Received Signal Strength Indication) */
int8_t rssi;
};
@@ -188,83 +188,83 @@
/* States each channel on a multiframe */
struct trx_lchan_state {
- /*! \brief Channel type */
+ /*! Channel type */
enum trx_lchan_type type;
- /*! \brief Channel status */
+ /*! Channel status */
uint8_t active;
- /*! \brief Link to a list of channels */
+ /*! Link to a list of channels */
struct llist_head list;
- /*! \brief Burst type: GMSK or 8PSK */
+ /*! Burst type: GMSK or 8PSK */
enum trx_burst_type burst_type;
- /*! \brief Mask of received bursts */
+ /*! Mask of received bursts */
uint8_t rx_burst_mask;
- /*! \brief Mask of transmitted bursts */
+ /*! Mask of transmitted bursts */
uint8_t tx_burst_mask;
- /*! \brief Burst buffer for RX */
+ /*! Burst buffer for RX */
sbit_t *rx_bursts;
- /*! \brief Burst buffer for TX */
+ /*! Burst buffer for TX */
ubit_t *tx_bursts;
- /*! \brief A primitive being sent */
+ /*! A primitive being sent */
struct trx_ts_prim *prim;
- /*! \brief Mode for TCH channels (see GSM48_CMODE_*) */
+ /*! Mode for TCH channels (see GSM48_CMODE_*) */
uint8_t tch_mode;
- /*! \brief FACCH/H on downlink */
+ /*! FACCH/H on downlink */
bool dl_ongoing_facch;
- /*! \brief pending FACCH/H blocks on Uplink */
+ /*! pending FACCH/H blocks on Uplink */
uint8_t ul_facch_blocks;
- /*! \brief Downlink measurements history */
+ /*! Downlink measurements history */
struct trx_lchan_meas_hist meas_hist;
- /*! \brief AVG measurements of the last received block */
+ /*! AVG measurements of the last received block */
struct trx_meas_set meas_avg;
- /*! \brief TDMA loss detection state */
+ /*! TDMA loss detection state */
struct {
- /*! \brief Last processed TDMA frame number */
+ /*! Last processed TDMA frame number */
uint32_t last_proc;
- /*! \brief Number of processed TDMA frames */
+ /*! Number of processed TDMA frames */
unsigned long num_proc;
- /*! \brief Number of lost TDMA frames */
+ /*! Number of lost TDMA frames */
unsigned long num_lost;
} tdma;
- /*! \brief SACCH state */
+ /*! SACCH state */
struct {
- /*! \brief Cached measurement report (last received) */
+ /*! Cached measurement report (last received) */
uint8_t mr_cache[GSM_MACBLOCK_LEN];
- /*! \brief Cache usage counter */
+ /*! Cache usage counter */
uint8_t mr_cache_usage;
- /*! \brief Was a MR transmitted last time? */
+ /*! Was a MR transmitted last time? */
bool mr_tx_last;
} sacch;
/* AMR specific */
struct {
- /*! \brief 4 possible codecs for AMR */
+ /*! 4 possible codecs for AMR */
uint8_t codec[4];
- /*! \brief Number of possible codecs */
+ /*! Number of possible codecs */
uint8_t codecs;
- /*! \brief Current uplink FT index */
+ /*! Current uplink FT index */
uint8_t ul_ft;
- /*! \brief Current downlink FT index */
+ /*! Current downlink FT index */
uint8_t dl_ft;
- /*! \brief Current uplink CMR index */
+ /*! Current uplink CMR index */
uint8_t ul_cmr;
- /*! \brief Current downlink CMR index */
+ /*! Current downlink CMR index */
uint8_t dl_cmr;
- /*! \brief If AMR loop is enabled */
+ /*! If AMR loop is enabled */
uint8_t amr_loop;
- /*! \brief Number of bit error rates */
+ /*! Number of bit error rates */
uint8_t ber_num;
- /*! \brief Sum of bit error rates */
+ /*! Sum of bit error rates */
float ber_sum;
} amr;
- /*! \brief A5/X encryption state */
+ /*! A5/X encryption state */
struct {
uint8_t key[MAX_A5_KEY_LEN];
uint8_t key_len;
@@ -276,14 +276,14 @@
};
struct trx_ts {
- /*! \brief Timeslot index within a frame (0..7) */
+ /*! Timeslot index within a frame (0..7) */
uint8_t index;
- /*! \brief Pointer to multiframe layout */
+ /*! Pointer to multiframe layout */
const struct trx_multiframe *mf_layout;
- /*! \brief Channel states for logical channels */
+ /*! Channel states for logical channels */
struct llist_head lchans;
- /*! \brief Queue primitives for TX */
+ /*! Queue primitives for TX */
struct llist_head tx_prims;
/* backpointer to its TRX */
struct trx_instance *trx;
@@ -291,13 +291,13 @@
/* Represents one TX primitive in the queue of trx_ts */
struct trx_ts_prim {
- /*! \brief Link to queue of TS */
+ /*! Link to queue of TS */
struct llist_head list;
- /*! \brief Logical channel type */
+ /*! Logical channel type */
enum trx_lchan_type chan;
- /*! \brief Payload length */
+ /*! Payload length */
size_t payload_len;
- /*! \brief Payload */
+ /*! Payload */
uint8_t payload[0];
};
diff --git a/src/host/trxcon/include/osmocom/bb/trxcon/scheduler.h b/src/host/trxcon/include/osmocom/bb/trxcon/scheduler.h
index 43127cc..a7e3fd9 100644
--- a/src/host/trxcon/include/osmocom/bb/trxcon/scheduler.h
+++ b/src/host/trxcon/include/osmocom/bb/trxcon/scheduler.h
@@ -14,23 +14,23 @@
/* Forward structure declaration */
struct trx_sched;
-/*! \brief One scheduler instance */
+/*! One scheduler instance */
struct trx_sched {
- /*! \brief Clock state */
+ /*! Clock state */
enum tdma_sched_clck_state state;
- /*! \brief Local clock source */
+ /*! Local clock source */
struct timespec clock;
- /*! \brief Count of processed frames */
+ /*! Count of processed frames */
uint32_t fn_counter_proc;
- /*! \brief Local frame counter advance */
+ /*! Local frame counter advance */
uint32_t fn_counter_advance;
- /*! \brief Count of lost frames */
+ /*! Count of lost frames */
uint32_t fn_counter_lost;
- /*! \brief Frame callback timer */
+ /*! Frame callback timer */
struct osmo_timer_list clock_timer;
- /*! \brief Frame callback */
+ /*! Frame callback */
void (*clock_cb)(struct trx_sched *sched);
- /*! \brief Private data (e.g. pointer to trx instance) */
+ /*! Private data (e.g. pointer to trx instance) */
void *data;
};
--
To view, visit https://gerrit.osmocom.org/c/osmocom-bb/+/28544
To unsubscribe, or for help writing mail filters, visit https://gerrit.osmocom.org/settings
Gerrit-Project: osmocom-bb
Gerrit-Branch: master
Gerrit-Change-Id: If793037e2b2bc9b708617867a4d4ddb0fa2f1ddb
Gerrit-Change-Number: 28544
Gerrit-PatchSet: 1
Gerrit-Owner: fixeria <vyanitskiy(a)sysmocom.de>
Gerrit-MessageType: newchange
Visit https://build.opensuse.org/package/live_build_log/network:osmocom:nightly/o…
Package network:osmocom:nightly/osmo-msc failed to build in Raspbian_10/armv7l
Check out the package for editing:
osc checkout network:osmocom:nightly osmo-msc
Last lines of build log:
[ 192s] [465/485] installing python-apt-1.8.4.3
[ 192s] [466/485] installing graphviz-2.40.1-6+deb10u1
[ 192s] [467/485] installing adwaita-icon-theme-3.30.1-1
[ 196s] update-alternatives: using /usr/share/icons/Adwaita/cursor.theme to provide /usr/share/icons/default/index.theme (x-cursor-theme) in auto mode
[ 196s] [468/485] installing texlive-bibtex-extra-2018.20190227-2
[ 205s] [469/485] installing texlive-latex-recommended-2018.20190227-2
[ 208s] [470/485] installing tipa-2:1.3-20
[ 208s] Regenerating '/var/lib/texmf/fmtutil.cnf-DEBIAN'... done.
[ 208s] Regenerating '/var/lib/texmf/fmtutil.cnf-TEXLIVEDIST'... done.
[ 208s] update-fmtutil has updated the following file(s):
[ 208s] /var/lib/texmf/fmtutil.cnf-DEBIAN
[ 208s] /var/lib/texmf/fmtutil.cnf-TEXLIVEDIST
[ 208s] If you want to activate the changes in the above file(s),
[ 208s] you should run fmtutil-sys or fmtutil.
[ 208s] [471/485] installing texlive-extra-utils-2018.20190227-2
[ 213s] dpkg-deb (subprocess): decompressing archive member: lzma error: compressed data is corrupt
[ 213s] dpkg-deb: error: <decompress> subprocess returned error exit status 2
[ 213s] dpkg: error processing archive .init_b_cache/texlive-extra-utils.deb (--install):
[ 213s] cannot copy extracted data for './usr/share/doc/texlive-doc/support/texcount/doc/QuickReference.pdf' to '/usr/share/doc/texlive-doc/support/texcount/doc/QuickReference.pdf.dpkg-new': unexpected end of file or stream
[ 213s] Errors were encountered while processing:
[ 213s] .init_b_cache/texlive-extra-utils.deb
[ 213s] exit ...
[ 213s] ### VM INTERACTION START ###
[ 213s] [ 183.040229] sysrq: SysRq : Power Off
[ 213s] [ 183.041607] reboot: Power down
[ 213s] ### VM INTERACTION END ###
[ 214s]
[ 214s] armbuild01 failed "build osmo-msc_1.9.0.2.99bd.202207090052.dsc" at Sat Jul 9 03:46:12 UTC 2022.
[ 214s]
--
Configure notifications at https://build.opensuse.org/my/subscriptions
openSUSE Build Service (https://build.opensuse.org/)