include/l1ctl_proto.h

   1 /* Messages to be sent between the different layers */
   2
   3 /* (C) 2010 by Harald Welte <laforge@gnumonks.org>
   4  * (C) 2010 by Holger Hans Peter Freyther
   5  *
   6  * All Rights Reserved
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License along
  19  * with this program; if not, write to the Free Software Foundation, Inc.,
  20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  21  *
  22  */
  23
  24 #ifndef __L1CTL_PROTO_H__
  25 #define __L1CTL_PROTO_H__
  26
  27 enum {
  28         _L1CTL_NONE             = 0,
  29         L1CTL_FBSB_REQ,
  30         L1CTL_FBSB_CONF,
  31         L1CTL_DATA_IND,
  32         L1CTL_RACH_REQ,
  33         L1CTL_DM_EST_REQ,
  34         L1CTL_DATA_REQ,
  35         L1CTL_RESET_IND,
  36         L1CTL_PM_REQ,           /* power measurement */
  37         L1CTL_PM_CONF,          /* power measurement */
  38         L1CTL_ECHO_REQ,
  39         L1CTL_ECHO_CONF,
  40         L1CTL_RACH_CONF,
  41         L1CTL_RESET_REQ,
  42         L1CTL_RESET_CONF,
  43         L1CTL_DATA_CONF,
  44         L1CTL_CCCH_MODE_REQ,
  45         L1CTL_CCCH_MODE_CONF,
  46         L1CTL_DM_REL_REQ,
  47         L1CTL_PARAM_REQ,
  48         L1CTL_DM_FREQ_REQ,
  49         L1CTL_CRYPTO_REQ,
  50         L1CTL_SIM_REQ,
  51         L1CTL_SIM_CONF,
  52         L1CTL_TCH_MODE_REQ,
  53         L1CTL_TCH_MODE_CONF,
  54         L1CTL_NEIGH_PM_REQ,
  55         L1CTL_NEIGH_PM_IND,
  56         L1CTL_TRAFFIC_REQ,
  57         L1CTL_TRAFFIC_CONF,
  58         L1CTL_TRAFFIC_IND,
  59 };
  60
  61 enum ccch_mode {
  62         CCCH_MODE_NONE = 0,
  63         CCCH_MODE_NON_COMBINED,
  64         CCCH_MODE_COMBINED,
  65 };
  66
  67 enum neigh_mode {
  68         NEIGH_MODE_NONE = 0,
  69         NEIGH_MODE_PM,
  70         NEIGH_MODE_SB,
  71 };
  72
  73 #define TRAFFIC_DATA_LEN        40
  74
  75 /*
  76  * NOTE: struct size. We do add manual padding out of the believe
  77  * that it will avoid some unaligned access.
  78  */
  79
  80 /* there are no more messages in a sequence */
  81 #define L1CTL_F_DONE    0x01
  82
  83 struct l1ctl_hdr {
  84         uint8_t msg_type;
  85         uint8_t flags;
  86         uint8_t padding[2];
  87         uint8_t data[0];
  88 } __attribute__((packed));
  89
  90 /*
  91  * downlink info ... down from the BTS..
  92  */
  93 struct l1ctl_info_dl {
  94         /* GSM 08.58 channel number (9.3.1) */
  95         uint8_t chan_nr;
  96         /* GSM 08.58 link identifier (9.3.2) */
  97         uint8_t link_id;
  98         /* the ARFCN and the band. FIXME: what about MAIO? */
  99         uint16_t band_arfcn;
 100
 101         uint32_t frame_nr;
 102
 103         uint8_t rx_level;       /* 0 .. 63 in typical GSM notation (dBm+110) */
 104         uint8_t snr;            /* Signal/Noise Ration (dB) */
 105         uint8_t num_biterr;
 106         uint8_t fire_crc;
 107
 108         uint8_t payload[0];
 109 } __attribute__((packed));
 110
 111 /* new CCCH was found. This is following the header */
 112 struct l1ctl_fbsb_conf {
 113         int16_t initial_freq_err;
 114         uint8_t result;
 115         uint8_t bsic;
 116         /* FIXME: contents of cell_info ? */
 117 } __attribute__((packed));
 118
 119 /* CCCH mode was changed */
 120 struct l1ctl_ccch_mode_conf {
 121         uint8_t ccch_mode;      /* enum ccch_mode */
 122         uint8_t padding[3];
 123 } __attribute__((packed));
 124
 125 /* TCH mode was changed */
 126 struct l1ctl_tch_mode_conf {
 127         uint8_t tch_mode;       /* enum tch_mode */
 128         uint8_t audio_mode;
 129         uint8_t padding[2];
 130 } __attribute__((packed));
 131
 132 /* data on the CCCH was found. This is following the header */
 133 struct l1ctl_data_ind {
 134         uint8_t data[23];
 135 } __attribute__((packed));
 136
 137 /* traffic from the network */
 138 struct l1ctl_traffic_ind {
 139         uint8_t data[TRAFFIC_DATA_LEN];
 140 } __attribute__((packed));
 141
 142 /*
 143  * uplink info
 144  */
 145 struct l1ctl_info_ul {
 146         /* GSM 08.58 channel number (9.3.1) */
 147         uint8_t chan_nr;
 148         /* GSM 08.58 link identifier (9.3.2) */
 149         uint8_t link_id;
 150         uint8_t padding[2];
 151
 152         uint8_t payload[0];
 153 } __attribute__((packed));
 154
 155 /*
 156  * msg for FBSB_REQ
 157  * the l1_info_ul header is in front
 158  */
 159 struct l1ctl_fbsb_req {
 160         uint16_t band_arfcn;
 161         uint16_t timeout;       /* in TDMA frames */
 162
 163         uint16_t freq_err_thresh1;
 164         uint16_t freq_err_thresh2;
 165
 166         uint8_t num_freqerr_avg;
 167         uint8_t flags;          /* L1CTL_FBSB_F_* */
 168         uint8_t sync_info_idx;
 169         uint8_t ccch_mode;      /* enum ccch_mode */
 170 } __attribute__((packed));
 171
 172 #define L1CTL_FBSB_F_FB0        (1 << 0)
 173 #define L1CTL_FBSB_F_FB1        (1 << 1)
 174 #define L1CTL_FBSB_F_SB         (1 << 2)
 175 #define L1CTL_FBSB_F_FB01SB     (L1CTL_FBSB_F_FB0|L1CTL_FBSB_F_FB1|L1CTL_FBSB_F_SB)
 176
 177 /*
 178  * msg for CCCH_MODE_REQ
 179  * the l1_info_ul header is in front
 180  */
 181 struct l1ctl_ccch_mode_req {
 182         uint8_t ccch_mode;      /* enum ccch_mode */
 183         uint8_t padding[3];
 184 } __attribute__((packed));
 185
 186 /*
 187  * msg for TCH_MODE_REQ
 188  * the l1_info_ul header is in front
 189  */
 190 struct l1ctl_tch_mode_req {
 191         uint8_t tch_mode;       /* enum gsm48_chan_mode */
 192 #define AUDIO_TX_MICROPHONE     (1<<0)
 193 #define AUDIO_TX_TRAFFIC_REQ    (1<<1)
 194 #define AUDIO_RX_SPEAKER        (1<<2)
 195 #define AUDIO_RX_TRAFFIC_IND    (1<<3)
 196         uint8_t audio_mode;
 197         uint8_t padding[2];
 198 } __attribute__((packed));
 199
 200 /* the l1_info_ul header is in front */
 201 struct l1ctl_rach_req {
 202         uint8_t ra;
 203         uint8_t combined;
 204         uint16_t offset;
 205 } __attribute__((packed));
 206
 207 /* the l1_info_ul header is in front */
 208 struct l1ctl_par_req {
 209         int8_t ta;
 210         uint8_t tx_power;
 211         uint8_t padding[2];
 212 } __attribute__((packed));
 213
 214 struct l1ctl_h0 {
 215         uint16_t band_arfcn;
 216 } __attribute__((packed));
 217
 218 struct l1ctl_h1 {
 219         uint8_t hsn;
 220         uint8_t maio;
 221         uint8_t n;
 222         uint8_t _padding[1];
 223         uint16_t ma[64];
 224 } __attribute__((packed));
 225
 226 struct l1ctl_dm_est_req {
 227         uint8_t tsc;
 228         uint8_t h;
 229         union {
 230                 struct l1ctl_h0 h0;
 231                 struct l1ctl_h1 h1;
 232         };
 233         uint8_t tch_mode;
 234         uint8_t audio_mode;
 235 } __attribute__((packed));
 236
 237 struct l1ctl_dm_freq_req {
 238         uint16_t fn;
 239         uint8_t tsc;
 240         uint8_t h;
 241         union {
 242                 struct l1ctl_h0 h0;
 243                 struct l1ctl_h1 h1;
 244         };
 245 } __attribute__((packed));
 246
 247 struct l1ctl_crypto_req {
 248         uint8_t algo;
 249         uint8_t key[0];
 250 } __attribute__((packed));
 251
 252 struct l1ctl_pm_req {
 253         uint8_t type;
 254         uint8_t padding[3];
 255
 256         union {
 257                 struct {
 258                         uint16_t band_arfcn_from;
 259                         uint16_t band_arfcn_to;
 260                 } range;
 261         };
 262 } __attribute__((packed));
 263
 264 /* a single L1CTL_PM response */
 265 struct l1ctl_pm_conf {
 266         uint16_t band_arfcn;
 267         uint8_t pm[2];
 268 } __attribute__((packed));
 269
 270 enum l1ctl_reset_type {
 271         L1CTL_RES_T_BOOT,       /* only _IND */
 272         L1CTL_RES_T_FULL,
 273         L1CTL_RES_T_SCHED,
 274 };
 275
 276 /* argument to L1CTL_RESET_REQ and L1CTL_RESET_IND */
 277 struct l1ctl_reset {
 278         uint8_t type;
 279         uint8_t pad[3];
 280 } __attribute__((packed));
 281
 282 struct l1ctl_neigh_pm_req {
 283         uint8_t n;
 284         uint8_t padding[1];
 285         uint16_t band_arfcn[64];
 286 } __attribute__((packed));
 287
 288 /* neighbour cell measurement results */
 289 struct l1ctl_neigh_pm_ind {
 290         uint16_t band_arfcn;
 291         uint8_t pm[2];
 292 } __attribute__((packed));
 293
 294 /* traffic data to network */
 295 struct l1ctl_traffic_req {
 296         uint8_t data[TRAFFIC_DATA_LEN];
 297 } __attribute__((packed));
 298
 299 #endif /* __L1CTL_PROTO_H__ */