sys/net/i4b/include/i386/i4b_debug.h

   1 /*
   2  * Copyright (c) 1997, 2001 Hellmuth Michaelis. All rights reserved.
   3  *
   4  * Redistribution and use in source and binary forms, with or without
   5  * modification, are permitted provided that the following conditions
   6  * are met:
   7  * 1. Redistributions of source code must retain the above copyright
   8  *    notice, this list of conditions and the following disclaimer.
   9  * 2. Redistributions in binary form must reproduce the above copyright
  10  *    notice, this list of conditions and the following disclaimer in the
  11  *    documentation and/or other materials provided with the distribution.
  12  *
  13  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  17  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23  * SUCH DAMAGE.
  24  *
  25  *---------------------------------------------------------------------------
  26  *
  27  *      i4b_debug.h - i4b debug header file
  28  *      -----------------------------------
  29  *
  30  * $FreeBSD: src/sys/i386/include/i4b_debug.h,v 1.6.2.1 2001/08/01 17:45:01 obrien Exp $
  31  * $DragonFly: src/sys/net/i4b/include/i386/i4b_debug.h,v 1.5 2006/12/22 23:44:55 swildner Exp $
  32  *
  33  *      last edit-date: [Mon May 21 10:05:34 2001]
  34  *
  35  *---------------------------------------------------------------------------*/
  36
  37 #ifndef _I4B_DEBUG_H_
  38 #define _I4B_DEBUG_H_
  39
  40 #include <sys/ioccom.h>
  41
  42 #if !defined DO_I4B_DEBUG
  43 # define DO_I4B_DEBUG 1         /* default = include debugging code */
  44 #elif DO_I4B_DEBUG != 0
  45 # undef DO_I4B_DEBUG
  46 # define DO_I4B_DEBUG 1
  47 #endif
  48
  49 #undef DO_I4B_MAXDEBUG          /* default = disable ALL debug messages */
  50
  51 #if DO_I4B_DEBUG
  52
  53 extern unsigned int i4b_l1_debug;
  54 extern unsigned int i4b_l2_debug;
  55 extern unsigned int i4b_l3_debug;
  56 extern unsigned int i4b_l4_debug;
  57
  58 #define NDBGL1(bits, fmt, args...)                                      \
  59         if(bits & i4b_l1_debug)                                         \
  60         { kprintf("i4b-L1 %s: " fmt "\n", __func__ , ##args ); }
  61
  62 #define NDBGL2(bits, fmt, args...)                                      \
  63         if(bits & i4b_l2_debug)                                         \
  64         { kprintf("i4b-L2 %s: " fmt "\n", __func__ , ##args ); }
  65
  66 #define NDBGL3(bits, fmt, args...)                                      \
  67         if(bits & i4b_l3_debug)                                         \
  68         { kprintf("i4b-L3 %s: " fmt "\n", __func__ , ##args ); }
  69
  70 #define NDBGL4(bits, fmt, args...)                                      \
  71         if(bits & i4b_l4_debug)                                         \
  72         { kprintf("i4b-L4 %s: " fmt "\n", __func__ , ##args ); }
  73
  74 #else /* !DO_I4B_DEBUG */
  75
  76 #define NDBGL1(bits, fmt, args...);
  77 #define NDBGL2(bits, fmt, args...);
  78 #define NDBGL3(bits, fmt, args...);
  79 #define NDBGL4(bits, fmt, args...);
  80
  81 #endif /* DO_I4B_DEBUG */
  82
  83 /* Layer 1 */
  84
  85 #define L1_ERROR        0x000001        /* general error message*/
  86 #define L1_PRIM         0x000002        /* interlayer primitives*/
  87 #define L1_BCHAN        0x000004        /* B channel action     */
  88 #define L1_H_ERR        0x000008        /* HSCX errors          */
  89 #define L1_H_IRQ        0x000010        /* HSCX IRQ messages    */
  90 #define L1_I_ERR        0x000020        /* ISAC errors          */
  91 #define L1_I_MSG        0x000040        /* ISAC messages        */
  92 #define L1_I_SETUP      0x000080        /* ISAC setup messages  */
  93 #define L1_F_MSG        0x000100        /* FSM messages         */
  94 #define L1_F_ERR        0x000200        /* FSM error messages   */
  95 #define L1_T_MSG        0x000400        /* Timer messages       */
  96 #define L1_T_ERR        0x000800        /* Timer error messages */
  97 #define L1_H_XFRERR     0x001000        /* HSCX data xfer error */
  98 #define L1_I_CICO       0x002000        /* ISAC command in/out  */
  99 #define L1_S_MSG        0x004000        /* silent messages (soft-HDLC)  */
 100 #define L1_S_ERR        0x008000        /* error messages (soft-HDLC)   */
 101 #define L1_HFC_DBG      0x010000        /* HFC-S PCI messages */
 102 #define L1_DEBUG_MAX    0x01ffef        /* all messages on except IRQ!  */
 103 #define L1_DEBUG_ERR (L1_S_ERR | L1_H_ERR | L1_I_ERR | L1_F_ERR | L1_T_ERR | L1_ERROR)
 104
 105 #ifndef L1_DEBUG_DEFAULT
 106 #ifdef DO_I4B_MAXDEBUG
 107 #define L1_DEBUG_DEFAULT L1_DEBUG_MAX
 108 #else
 109 #define L1_DEBUG_DEFAULT L1_DEBUG_ERR
 110 #endif
 111 #endif
 112
 113 /* Layer 2 */
 114
 115 #define L2_ERROR        0x0001          /* general error message        */
 116 #define L2_PRIM         0x0002          /* interlayer primitives        */
 117 #define L2_U_MSG        0x0004          /* U frame messages             */
 118 #define L2_U_ERR        0x0008          /* U frame error messages       */
 119 #define L2_S_MSG        0x0010          /* S frame messages             */
 120 #define L2_S_ERR        0x0020          /* S frame error messages       */
 121 #define L2_I_MSG        0x0040          /* I frame messages             */
 122 #define L2_I_ERR        0x0080          /* I frame error messages       */
 123 #define L2_F_MSG        0x0100          /* FSM messages                 */
 124 #define L2_F_ERR        0x0200          /* FSM error messages           */
 125 #define L2_T_MSG        0x0400          /* timer messages               */
 126 #define L2_T_ERR        0x0800          /* timer error messages         */
 127 #define L2_TEI_MSG      0x1000          /* TEI messages                 */
 128 #define L2_TEI_ERR      0x2000          /* TEI error messages           */
 129
 130 #define L2_DEBUG_MAX    0x3fff          /* all messages on              */
 131 #define L2_DEBUG_ERR (L2_ERROR | L2_I_ERR | L2_F_ERR | L2_T_ERR | L2_S_ERR | L2_TEI_ERR | L2_U_ERR )
 132
 133 #ifndef L2_DEBUG_DEFAULT
 134 #ifdef DO_I4B_MAXDEBUG
 135 #define L2_DEBUG_DEFAULT L2_DEBUG_MAX
 136 #else
 137 #define L2_DEBUG_DEFAULT L2_DEBUG_ERR
 138 #endif
 139 #endif
 140
 141 /* Layer 3 */
 142
 143 #define L3_ERR          0x0001          /* general error message        */
 144 #define L3_MSG          0x0002          /* general message              */
 145 #define L3_F_MSG        0x0004          /* FSM messages                 */
 146 #define L3_F_ERR        0x0008          /* FSM error messages           */
 147 #define L3_T_MSG        0x0010          /* timer messages               */
 148 #define L3_T_ERR        0x0020          /* timer error messages         */
 149 #define L3_P_MSG        0x0040          /* protocol messages            */
 150 #define L3_P_ERR        0x0080          /* protocol error messages      */
 151 #define L3_A_MSG        0x0100          /* AOC messages                 */
 152 #define L3_A_ERR        0x0200          /* AOC error messages           */
 153 #define L3_PRIM         0x0400          /* messages exchanged           */
 154
 155 #define L3_DEBUG_MAX    0x07ff          /* all messages on      */
 156 #define L3_DEBUG_ERR    (L3_ERR | L3_F_ERR | L3_T_ERR | L3_P_ERR | L3_A_ERR)
 157
 158 #ifndef L3_DEBUG_DEFAULT
 159 #ifdef DO_I4B_MAXDEBUG
 160 #define L3_DEBUG_DEFAULT L3_DEBUG_MAX
 161 #else
 162 #define L3_DEBUG_DEFAULT L3_DEBUG_ERR
 163 #endif
 164 #endif
 165
 166 /* Layer 4 */
 167
 168 #define L4_ERR          0x0001          /* general error message        */
 169 #define L4_MSG          0x0002          /* general message              */
 170 #define L4_TIMO         0x0004          /* b channel idle timeout msgs  */
 171 #define L4_DIALST       0x0008          /* network driver dial states   */
 172 #define L4_IPRDBG       0x0010          /* ipr driver debug messages    */
 173 #define L4_RBCHDBG      0x0020          /* rbch driver debug messages   */
 174 #define L4_ISPDBG       0x0040          /* isp driver debug messages    */
 175 #define L4_TELDBG       0x0080          /* tel driver debug messages    */
 176 #define L4_INGDBG       0x0100          /* ing driver debug messages    */
 177 #define L4_IAVCDBG      0x0200          /* AVM B1 driver debug messages */
 178 #define L4_CAPIDBG      0x0400          /* CAPI driver debug messages   */
 179
 180 #define L4_DEBUG_MAX    0x0fff          /* all messages on      */
 181 #define L4_DEBUG_ERR    L4_ERR
 182
 183 #ifndef L4_DEBUG_DEFAULT
 184 #ifdef DO_I4B_MAXDEBUG
 185 #define L4_DEBUG_DEFAULT L4_DEBUG_MAX
 186 #else
 187 #define L4_DEBUG_DEFAULT L4_DEBUG_ERR
 188 #endif
 189 #endif
 190
 191 /*---------------------------------------------------------------------------*
 192  *      ioctl via /dev/i4bctl:
 193  *      get/set current debug bits settings
 194  *---------------------------------------------------------------------------*/
 195
 196 typedef struct {
 197         unsigned int    l1;
 198         unsigned int    l2;
 199         unsigned int    l3;
 200         unsigned int    l4;
 201 } ctl_debug_t;
 202
 203 #define I4B_CTL_GET_DEBUG       _IOR('C', 0, ctl_debug_t)
 204
 205 #define I4B_CTL_SET_DEBUG       _IOW('C', 1, ctl_debug_t)
 206
 207 /*---------------------------------------------------------------------------*
 208  *      generic get chipset statistics
 209  *---------------------------------------------------------------------------*/
 210
 211 /* for the ihfc-driver: structure for HFC-1/S/SP statistics */
 212
 213 typedef struct {
 214         int txframes;
 215         int rxframes;
 216         int xdu;
 217         int rdo;
 218         int crc;
 219         int rab;
 220 } hfcstat_t;
 221
 222
 223 /* for the isic-driver: structure for HSCX statistics */
 224
 225 typedef struct {
 226         int unit;       /* controller number */
 227         int chan;       /* channel number */
 228         int vfr;
 229         int rdo;
 230         int crc;
 231         int rab;
 232         int xdu;
 233         int rfo;
 234 } hscxstat_t;
 235
 236 /* generic statistics structure */
 237
 238 struct chipstat {
 239         int driver_type;                /* type, L1DRVR_XXXX            */
 240         int driver_unit;                /* the unit number              */
 241         int driver_bchannel;            /* the B-channel                */
 242         union stats {                   /* union for all drivers        */
 243                 hfcstat_t  hfcstat;     /* for ihfc driver, L1DRVR_IHFC */
 244                 hscxstat_t hscxstat;    /* for isic driver, L1DRVR_ISIC */
 245         } stats;
 246 };
 247
 248 /* get statistics */
 249
 250 #define I4B_CTL_GET_CHIPSTAT    _IOWR('C', 2, struct chipstat)
 251
 252 /* clear statistics */
 253
 254 #define I4B_CTL_CLR_CHIPSTAT    _IOW('C', 3, struct chipstat)
 255
 256 /*---------------------------------------------------------------------------*
 257  *      get LAPD/Q.921 statistics
 258  *---------------------------------------------------------------------------*/
 259 typedef struct {
 260
 261         /* transmit */
 262
 263         u_long  tx_i;           /* I    */
 264         u_long  tx_rr;          /* RR   */
 265         u_long  tx_rnr;         /* RNR  */
 266         u_long  tx_rej;         /* REJ  */
 267         u_long  tx_sabme;       /* SABME*/
 268         u_long  tx_dm;          /* DM   */
 269         u_long  tx_disc;        /* DISC */
 270         u_long  tx_ua;          /* UA   */
 271         u_long  tx_frmr;        /* FRMR */
 272         u_long  tx_tei;         /* TEI  */
 273
 274         /* receive */
 275
 276         u_long  rx_i;           /* I    */
 277         u_long  rx_rr;          /* RR   */
 278         u_long  rx_rnr;         /* RNR  */
 279         u_long  rx_rej;         /* REJ  */
 280         u_long  rx_sabme;       /* SABME*/
 281         u_long  rx_tei;         /* TEI  */
 282         u_long  rx_ui;          /* UI   */
 283         u_long  rx_disc;        /* DISC */
 284         u_long  rx_xid;         /* XID  */
 285         u_long  rx_dm;          /* DM   */
 286         u_long  rx_ua;          /* UA   */
 287         u_long  rx_frmr;        /* FRMR */
 288
 289         /* errors */
 290
 291         u_long  err_rx_len;     /* incorrect length */
 292         u_long  err_rx_badf;    /* bad frame type */
 293         u_long  err_rx_bads;    /* bad s frame */
 294         u_long  err_rx_badu;    /* bad u frame */
 295         u_long  err_rx_badui;   /* bad ui frame */
 296 } lapdstat_t;
 297
 298 typedef struct {
 299         int unit;
 300         lapdstat_t lapdstat;
 301 } l2stat_t;
 302
 303 #define I4B_CTL_GET_LAPDSTAT    _IOWR('C', 4, l2stat_t)
 304
 305 #define I4B_CTL_CLR_LAPDSTAT    _IOW('C', 5, int)
 306
 307 /* EOF */
 308
 309 #endif