trxd.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <stddef.h>
 
#include <osmocom/core/bits.h>
#include <osmocom/core/utils.h>
 
struct msgb;
 
#define OSMO_TRXD_PDU_VER_MAX           2
 
#define OSMO_TRXD_BURST_LEN_GMSK        148
#define OSMO_TRXD_BURST_LEN_8PSK        444
#define OSMO_TRXD_BURST_LEN_MAX         OSMO_TRXD_BURST_LEN_8PSK
 
#define OSMO_TRXD_HDR_LEN_MAX           12
#define OSMO_TRXD_MSG_BUF_SIZE          (OSMO_TRXD_HDR_LEN_MAX + OSMO_TRXD_BURST_LEN_MAX)
 
enum osmo_trxd_mod_type {
        OSMO_TRXD_MOD_T_GMSK,
        OSMO_TRXD_MOD_T_8PSK,
        OSMO_TRXD_MOD_T_AQPSK,
        /* room for 16QAM/32QAM */
};
 
/* Presence/meta flags for osmo_trxd_burst_{ind,req} */
#define OSMO_TRXD_F_NOPE_IND    (1 << 0) 
#define OSMO_TRXD_F_NOPE_REQ    OSMO_TRXD_F_NOPE_IND
#define OSMO_TRXD_F_MOD_TYPE    (1 << 1) 
#define OSMO_TRXD_F_TS_INFO     (1 << 2) 
#define OSMO_TRXD_F_CI_CB       (1 << 3) 
#define OSMO_TRXD_F_TRX_NUM     (1 << 4) 
#define OSMO_TRXD_F_BATCH_IND   (1 << 5) 
#define OSMO_TRXD_F_SHADOW_IND  (1 << 6) 
#define OSMO_TRXD_F_ACCESS_BURST (1 << 7) 
struct osmo_trxd_burst_ind {
        uint32_t flags;         
        /* Mandatory fields (all TRXD versions) */
        uint32_t fn;            
        uint8_t tn;             
        int16_t toa256;         
        int8_t rssi;            
        sbit_t burst[OSMO_TRXD_BURST_LEN_MAX]; 
        size_t burst_len;       
        /* Optional fields (presence indicated by flags) */
        enum osmo_trxd_mod_type mod; 
        uint8_t tsc_set;        
        uint8_t tsc;            
        int16_t ci_cb;          
        uint8_t trx_num;        
};
 
struct osmo_trxd_burst_req {
        uint32_t flags;         
        /* Mandatory fields (all TRXD versions) */
        uint32_t fn;            
        uint8_t tn;             
        uint8_t att;            
        ubit_t burst[OSMO_TRXD_BURST_LEN_MAX]; 
        size_t burst_len;       
        /* Optional fields (presence indicated by flags) */
        enum osmo_trxd_mod_type mod; 
        uint8_t tsc_set;        
        uint8_t tsc;            
        int8_t scpir;           
        uint8_t trx_num;        
};
 
struct osmo_trxd_parse_state {
        uint8_t pdu_ver;        
        unsigned int num_pdus;  
        uint32_t fn;            
};
 
void osmo_trxd_parse_state_init(struct osmo_trxd_parse_state *st);
 
int osmo_trxd_burst_ind_parse(struct osmo_trxd_parse_state *st,
                              struct osmo_trxd_burst_ind *bi,
                              const uint8_t *buf, size_t buf_len);
int osmo_trxd_burst_req_parse(struct osmo_trxd_parse_state *st,
                              struct osmo_trxd_burst_req *br,
                              const uint8_t *buf, size_t buf_len);
 
int osmo_trxd_burst_ind_build(struct msgb *msg, uint8_t pdu_ver,
                              const struct osmo_trxd_burst_ind *bi);
int osmo_trxd_burst_req_build(struct msgb *msg, uint8_t pdu_ver,
                              const struct osmo_trxd_burst_req *br);
void osmo_trxd_build_fin(struct msgb *msg, uint8_t pdu_ver);
 
const char *osmo_trxd_burst_ind_name(const struct osmo_trxd_burst_ind *bi);
char *osmo_trxd_burst_ind_name_buf(char *buf, size_t buf_len,
                                   const struct osmo_trxd_burst_ind *bi);
const char *osmo_trxd_burst_req_name(const struct osmo_trxd_burst_req *br);
char *osmo_trxd_burst_req_name_buf(char *buf, size_t buf_len,
                                   const struct osmo_trxd_burst_req *br);
 
extern const struct value_string osmo_trxd_mod_type_names[];
static inline const char *osmo_trxd_mod_type_name(enum osmo_trxd_mod_type mod)
{
        return get_value_string(osmo_trxd_mod_type_names, mod);
}