drivers/net/hamradio/baycom_par.c

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*****************************************************************************/
   3
   4 /*
   5  *      baycom_par.c  -- baycom par96 and picpar radio modem driver.
   6  *
   7  *      Copyright (C) 1996-2000  Thomas Sailer (sailer@ife.ee.ethz.ch)
   8  *
   9  *  Please note that the GPL allows you to use the driver, NOT the radio.
  10  *  In order to use the radio, you need a license from the communications
  11  *  authority of your country.
  12  *
  13  *  Supported modems
  14  *
  15  *  par96:  This is a modem for 9600 baud FSK compatible to the G3RUH standard.
  16  *          The modem does all the filtering and regenerates the receiver clock.
  17  *          Data is transferred from and to the PC via a shift register.
  18  *          The shift register is filled with 16 bits and an interrupt is
  19  *          signalled. The PC then empties the shift register in a burst. This
  20  *          modem connects to the parallel port, hence the name. The modem
  21  *          leaves the implementation of the HDLC protocol and the scrambler
  22  *          polynomial to the PC. This modem is no longer available (at least
  23  *          from Baycom) and has been replaced by the PICPAR modem (see below).
  24  *          You may however still build one from the schematics published in
  25  *          cq-DL :-).
  26  *
  27  *  picpar: This is a redesign of the par96 modem by Henning Rech, DF9IC. The
  28  *          modem is protocol compatible to par96, but uses only three low
  29  *          power ICs and can therefore be fed from the parallel port and
  30  *          does not require an additional power supply. It features
  31  *          built in DCD circuitry. The driver should therefore be configured
  32  *          for hardware DCD.
  33  *
  34  *  Command line options (insmod command line)
  35  *
  36  *  mode     driver mode string. Valid choices are par96 and picpar.
  37  *  iobase   base address of the port; common values are 0x378, 0x278, 0x3bc
  38  *
  39  *  History:
  40  *   0.1  26.06.1996  Adapted from baycom.c and made network driver interface
  41  *        18.10.1996  Changed to new user space access routines (copy_{to,from}_user)
  42  *   0.3  26.04.1997  init code/data tagged
  43  *   0.4  08.07.1997  alternative ser12 decoding algorithm (uses delta CTS ints)
  44  *   0.5  11.11.1997  split into separate files for ser12/par96
  45  *   0.6  03.08.1999  adapt to Linus' new __setup/__initcall
  46  *                    removed some pre-2.2 kernel compatibility cruft
  47  *   0.7  10.08.1999  Check if parport can do SPP and is safe to access during interrupt contexts
  48  *   0.8  12.02.2000  adapted to softnet driver interface
  49  *                    removed direct parport access, uses parport driver methods
  50  *   0.9  03.07.2000  fix interface name handling
  51  */
  52
  53 /*****************************************************************************/
  54
  55 #include <linux/module.h>
  56 #include <linux/kernel.h>
  57 #include <linux/types.h>
  58 #include <linux/fcntl.h>
  59 #include <linux/interrupt.h>
  60 #include <linux/ioport.h>
  61 #include <linux/in.h>
  62 #include <linux/string.h>
  63 #include <linux/init.h>
  64 #include <linux/delay.h>
  65 #include <linux/errno.h>
  66 #include <linux/netdevice.h>
  67 #include <linux/hdlcdrv.h>
  68 #include <linux/baycom.h>
  69 #include <linux/parport.h>
  70 #include <linux/bitops.h>
  71 #include <linux/jiffies.h>
  72
  73 #include <linux/uaccess.h>
  74
  75 /* --------------------------------------------------------------------- */
  76
  77 #define BAYCOM_DEBUG
  78
  79 /*
  80  * modem options; bit mask
  81  */
  82 #define BAYCOM_OPTIONS_SOFTDCD  1
  83
  84 /* --------------------------------------------------------------------- */
  85
  86 static const char bc_drvname[] = "baycom_par";
  87 static const char bc_drvinfo[] = KERN_INFO "baycom_par: (C) 1996-2000 Thomas Sailer, HB9JNX/AE4WA\n"
  88 "baycom_par: version 0.9\n";
  89
  90 /* --------------------------------------------------------------------- */
  91
  92 #define NR_PORTS 4
  93
  94 static struct net_device *baycom_device[NR_PORTS];
  95
  96 /* --------------------------------------------------------------------- */
  97
  98 #define PAR96_BURSTBITS 16
  99 #define PAR96_BURST     4
 100 #define PAR96_PTT       2
 101 #define PAR96_TXBIT     1
 102 #define PAR96_ACK       0x40
 103 #define PAR96_RXBIT     0x20
 104 #define PAR96_DCD       0x10
 105 #define PAR97_POWER     0xf8
 106
 107 /* ---------------------------------------------------------------------- */
 108 /*
 109  * Information that need to be kept for each board.
 110  */
 111
 112 struct baycom_state {
 113         struct hdlcdrv_state hdrv;
 114
 115         struct pardevice *pdev;
 116         unsigned int options;
 117
 118         struct modem_state {
 119                 short arb_divider;
 120                 unsigned char flags;
 121                 unsigned int shreg;
 122                 struct modem_state_par96 {
 123                         int dcd_count;
 124                         unsigned int dcd_shreg;
 125                         unsigned long descram;
 126                         unsigned long scram;
 127                 } par96;
 128         } modem;
 129
 130 #ifdef BAYCOM_DEBUG
 131         struct debug_vals {
 132                 unsigned long last_jiffies;
 133                 unsigned cur_intcnt;
 134                 unsigned last_intcnt;
 135                 int cur_pllcorr;
 136                 int last_pllcorr;
 137         } debug_vals;
 138 #endif /* BAYCOM_DEBUG */
 139 };
 140
 141 /* --------------------------------------------------------------------- */
 142
 143 static inline void baycom_int_freq(struct baycom_state *bc)
 144 {
 145 #ifdef BAYCOM_DEBUG
 146         unsigned long cur_jiffies = jiffies;
 147         /*
 148          * measure the interrupt frequency
 149          */
 150         bc->debug_vals.cur_intcnt++;
 151         if (time_after_eq(cur_jiffies, bc->debug_vals.last_jiffies + HZ)) {
 152                 bc->debug_vals.last_jiffies = cur_jiffies;
 153                 bc->debug_vals.last_intcnt = bc->debug_vals.cur_intcnt;
 154                 bc->debug_vals.cur_intcnt = 0;
 155                 bc->debug_vals.last_pllcorr = bc->debug_vals.cur_pllcorr;
 156                 bc->debug_vals.cur_pllcorr = 0;
 157         }
 158 #endif /* BAYCOM_DEBUG */
 159 }
 160
 161 /* --------------------------------------------------------------------- */
 162 /*
 163  * ===================== PAR96 specific routines =========================
 164  */
 165
 166 #define PAR96_DESCRAM_TAP1 0x20000
 167 #define PAR96_DESCRAM_TAP2 0x01000
 168 #define PAR96_DESCRAM_TAP3 0x00001
 169
 170 #define PAR96_DESCRAM_TAPSH1 17
 171 #define PAR96_DESCRAM_TAPSH2 12
 172 #define PAR96_DESCRAM_TAPSH3 0
 173
 174 #define PAR96_SCRAM_TAP1 0x20000 /* X^17 */
 175 #define PAR96_SCRAM_TAPN 0x00021 /* X^0+X^5 */
 176
 177 /* --------------------------------------------------------------------- */
 178
 179 static inline void par96_tx(struct net_device *dev, struct baycom_state *bc)
 180 {
 181         int i;
 182         unsigned int data = hdlcdrv_getbits(&bc->hdrv);
 183         struct parport *pp = bc->pdev->port;
 184
 185         for(i = 0; i < PAR96_BURSTBITS; i++, data >>= 1) {
 186                 unsigned char val = PAR97_POWER;
 187                 bc->modem.par96.scram = ((bc->modem.par96.scram << 1) |
 188                                          (bc->modem.par96.scram & 1));
 189                 if (!(data & 1))
 190                         bc->modem.par96.scram ^= 1;
 191                 if (bc->modem.par96.scram & (PAR96_SCRAM_TAP1 << 1))
 192                         bc->modem.par96.scram ^=
 193                                 (PAR96_SCRAM_TAPN << 1);
 194                 if (bc->modem.par96.scram & (PAR96_SCRAM_TAP1 << 2))
 195                         val |= PAR96_TXBIT;
 196                 pp->ops->write_data(pp, val);
 197                 pp->ops->write_data(pp, val | PAR96_BURST);
 198         }
 199 }
 200
 201 /* --------------------------------------------------------------------- */
 202
 203 static inline void par96_rx(struct net_device *dev, struct baycom_state *bc)
 204 {
 205         int i;
 206         unsigned int data, mask, mask2, descx;
 207         struct parport *pp = bc->pdev->port;
 208
 209         /*
 210          * do receiver; differential decode and descramble on the fly
 211          */
 212         for(data = i = 0; i < PAR96_BURSTBITS; i++) {
 213                 bc->modem.par96.descram = (bc->modem.par96.descram << 1);
 214                 if (pp->ops->read_status(pp) & PAR96_RXBIT)
 215                         bc->modem.par96.descram |= 1;
 216                 descx = bc->modem.par96.descram ^
 217                         (bc->modem.par96.descram >> 1);
 218                 /* now the diff decoded data is inverted in descram */
 219                 pp->ops->write_data(pp, PAR97_POWER | PAR96_PTT);
 220                 descx ^= ((descx >> PAR96_DESCRAM_TAPSH1) ^
 221                           (descx >> PAR96_DESCRAM_TAPSH2));
 222                 data >>= 1;
 223                 if (!(descx & 1))
 224                         data |= 0x8000;
 225                 pp->ops->write_data(pp, PAR97_POWER | PAR96_PTT | PAR96_BURST);
 226         }
 227         hdlcdrv_putbits(&bc->hdrv, data);
 228         /*
 229          * do DCD algorithm
 230          */
 231         if (bc->options & BAYCOM_OPTIONS_SOFTDCD) {
 232                 bc->modem.par96.dcd_shreg = (bc->modem.par96.dcd_shreg >> 16)
 233                         | (data << 16);
 234                 /* search for flags and set the dcd counter appropriately */
 235                 for(mask = 0x1fe00, mask2 = 0xfc00, i = 0;
 236                     i < PAR96_BURSTBITS; i++, mask <<= 1, mask2 <<= 1)
 237                         if ((bc->modem.par96.dcd_shreg & mask) == mask2)
 238                                 bc->modem.par96.dcd_count = HDLCDRV_MAXFLEN+4;
 239                 /* check for abort/noise sequences */
 240                 for(mask = 0x1fe00, mask2 = 0x1fe00, i = 0;
 241                     i < PAR96_BURSTBITS; i++, mask <<= 1, mask2 <<= 1)
 242                         if (((bc->modem.par96.dcd_shreg & mask) == mask2) &&
 243                             (bc->modem.par96.dcd_count >= 0))
 244                                 bc->modem.par96.dcd_count -= HDLCDRV_MAXFLEN-10;
 245                 /* decrement and set the dcd variable */
 246                 if (bc->modem.par96.dcd_count >= 0)
 247                         bc->modem.par96.dcd_count -= 2;
 248                 hdlcdrv_setdcd(&bc->hdrv, bc->modem.par96.dcd_count > 0);
 249         } else {
 250                 hdlcdrv_setdcd(&bc->hdrv, !!(pp->ops->read_status(pp) & PAR96_DCD));
 251         }
 252 }
 253
 254 /* --------------------------------------------------------------------- */
 255
 256 static void par96_interrupt(void *dev_id)
 257 {
 258         struct net_device *dev = dev_id;
 259         struct baycom_state *bc = netdev_priv(dev);
 260
 261         baycom_int_freq(bc);
 262         /*
 263          * check if transmitter active
 264          */
 265         if (hdlcdrv_ptt(&bc->hdrv))
 266                 par96_tx(dev, bc);
 267         else {
 268                 par96_rx(dev, bc);
 269                 if (--bc->modem.arb_divider <= 0) {
 270                         bc->modem.arb_divider = 6;
 271                         local_irq_enable();
 272                         hdlcdrv_arbitrate(dev, &bc->hdrv);
 273                 }
 274         }
 275         local_irq_enable();
 276         hdlcdrv_transmitter(dev, &bc->hdrv);
 277         hdlcdrv_receiver(dev, &bc->hdrv);
 278         local_irq_disable();
 279 }
 280
 281 /* --------------------------------------------------------------------- */
 282
 283 static void par96_wakeup(void *handle)
 284 {
 285         struct net_device *dev = (struct net_device *)handle;
 286         struct baycom_state *bc = netdev_priv(dev);
 287
 288         printk(KERN_DEBUG "baycom_par: %s: why am I being woken up?\n", dev->name);
 289         if (!parport_claim(bc->pdev))
 290                 printk(KERN_DEBUG "baycom_par: %s: I'm broken.\n", dev->name);
 291 }
 292
 293 /* --------------------------------------------------------------------- */
 294
 295 static int par96_open(struct net_device *dev)
 296 {
 297         struct baycom_state *bc = netdev_priv(dev);
 298         struct pardev_cb par_cb;
 299         struct parport *pp;
 300         int i;
 301
 302         if (!dev || !bc)
 303                 return -ENXIO;
 304         pp = parport_find_base(dev->base_addr);
 305         if (!pp) {
 306                 printk(KERN_ERR "baycom_par: parport at 0x%lx unknown\n", dev->base_addr);
 307                 return -ENXIO;
 308         }
 309         if (pp->irq < 0) {
 310                 printk(KERN_ERR "baycom_par: parport at 0x%lx has no irq\n", pp->base);
 311                 parport_put_port(pp);
 312                 return -ENXIO;
 313         }
 314         if ((~pp->modes) & (PARPORT_MODE_PCSPP | PARPORT_MODE_SAFEININT)) {
 315                 printk(KERN_ERR "baycom_par: parport at 0x%lx cannot be used\n", pp->base);
 316                 parport_put_port(pp);
 317                 return -ENXIO;
 318         }
 319         memset(&bc->modem, 0, sizeof(bc->modem));
 320         bc->hdrv.par.bitrate = 9600;
 321         memset(&par_cb, 0, sizeof(par_cb));
 322         par_cb.wakeup = par96_wakeup;
 323         par_cb.irq_func = par96_interrupt;
 324         par_cb.private = (void *)dev;
 325         par_cb.flags = PARPORT_DEV_EXCL;
 326         for (i = 0; i < NR_PORTS; i++)
 327                 if (baycom_device[i] == dev)
 328                         break;
 329
 330         if (i == NR_PORTS) {
 331                 pr_err("%s: no device found\n", bc_drvname);
 332                 parport_put_port(pp);
 333                 return -ENODEV;
 334         }
 335         bc->pdev = parport_register_dev_model(pp, dev->name, &par_cb, i);
 336         parport_put_port(pp);
 337         if (!bc->pdev) {
 338                 printk(KERN_ERR "baycom_par: cannot register parport at 0x%lx\n", dev->base_addr);
 339                 return -ENXIO;
 340         }
 341         if (parport_claim(bc->pdev)) {
 342                 printk(KERN_ERR "baycom_par: parport at 0x%lx busy\n", pp->base);
 343                 parport_unregister_device(bc->pdev);
 344                 return -EBUSY;
 345         }
 346         pp = bc->pdev->port;
 347         dev->irq = pp->irq;
 348         pp->ops->data_forward(pp);
 349         bc->hdrv.par.bitrate = 9600;
 350         pp->ops->write_data(pp, PAR96_PTT | PAR97_POWER); /* switch off PTT */
 351         pp->ops->enable_irq(pp);
 352         printk(KERN_INFO "%s: par96 at iobase 0x%lx irq %u options 0x%x\n",
 353                bc_drvname, dev->base_addr, dev->irq, bc->options);
 354         return 0;
 355 }
 356
 357 /* --------------------------------------------------------------------- */
 358
 359 static int par96_close(struct net_device *dev)
 360 {
 361         struct baycom_state *bc = netdev_priv(dev);
 362         struct parport *pp;
 363
 364         if (!dev || !bc)
 365                 return -EINVAL;
 366         pp = bc->pdev->port;
 367         /* disable interrupt */
 368         pp->ops->disable_irq(pp);
 369         /* switch off PTT */
 370         pp->ops->write_data(pp, PAR96_PTT | PAR97_POWER);
 371         parport_release(bc->pdev);
 372         parport_unregister_device(bc->pdev);
 373         printk(KERN_INFO "%s: close par96 at iobase 0x%lx irq %u\n",
 374                bc_drvname, dev->base_addr, dev->irq);
 375         return 0;
 376 }
 377
 378 /* --------------------------------------------------------------------- */
 379 /*
 380  * ===================== hdlcdrv driver interface =========================
 381  */
 382
 383 static int baycom_ioctl(struct net_device *dev, struct ifreq *ifr,
 384                         struct hdlcdrv_ioctl *hi, int cmd);
 385
 386 /* --------------------------------------------------------------------- */
 387
 388 static const struct hdlcdrv_ops par96_ops = {
 389         .drvname = bc_drvname,
 390         .drvinfo = bc_drvinfo,
 391         .open    = par96_open,
 392         .close   = par96_close,
 393         .ioctl   = baycom_ioctl
 394 };
 395
 396 /* --------------------------------------------------------------------- */
 397
 398 static int baycom_setmode(struct baycom_state *bc, const char *modestr)
 399 {
 400         if (!strncmp(modestr, "picpar", 6))
 401                 bc->options = 0;
 402         else if (!strncmp(modestr, "par96", 5))
 403                 bc->options = BAYCOM_OPTIONS_SOFTDCD;
 404         else
 405                 bc->options = !!strchr(modestr, '*');
 406         return 0;
 407 }
 408
 409 /* --------------------------------------------------------------------- */
 410
 411 static int baycom_ioctl(struct net_device *dev, struct ifreq *ifr,
 412                         struct hdlcdrv_ioctl *hi, int cmd)
 413 {
 414         struct baycom_state *bc;
 415         struct baycom_ioctl bi;
 416
 417         if (!dev)
 418                 return -EINVAL;
 419
 420         bc = netdev_priv(dev);
 421         BUG_ON(bc->hdrv.magic != HDLCDRV_MAGIC);
 422
 423         if (cmd != SIOCDEVPRIVATE)
 424                 return -ENOIOCTLCMD;
 425         switch (hi->cmd) {
 426         default:
 427                 break;
 428
 429         case HDLCDRVCTL_GETMODE:
 430                 strcpy(hi->data.modename, bc->options ? "par96" : "picpar");
 431                 if (copy_to_user(ifr->ifr_data, hi, sizeof(struct hdlcdrv_ioctl)))
 432                         return -EFAULT;
 433                 return 0;
 434
 435         case HDLCDRVCTL_SETMODE:
 436                 if (netif_running(dev) || !capable(CAP_NET_ADMIN))
 437                         return -EACCES;
 438                 hi->data.modename[sizeof(hi->data.modename)-1] = '\0';
 439                 return baycom_setmode(bc, hi->data.modename);
 440
 441         case HDLCDRVCTL_MODELIST:
 442                 strcpy(hi->data.modename, "par96,picpar");
 443                 if (copy_to_user(ifr->ifr_data, hi, sizeof(struct hdlcdrv_ioctl)))
 444                         return -EFAULT;
 445                 return 0;
 446
 447         case HDLCDRVCTL_MODEMPARMASK:
 448                 return HDLCDRV_PARMASK_IOBASE;
 449
 450         }
 451
 452         if (copy_from_user(&bi, ifr->ifr_data, sizeof(bi)))
 453                 return -EFAULT;
 454         switch (bi.cmd) {
 455         default:
 456                 return -ENOIOCTLCMD;
 457
 458 #ifdef BAYCOM_DEBUG
 459         case BAYCOMCTL_GETDEBUG:
 460                 bi.data.dbg.debug1 = bc->hdrv.ptt_keyed;
 461                 bi.data.dbg.debug2 = bc->debug_vals.last_intcnt;
 462                 bi.data.dbg.debug3 = bc->debug_vals.last_pllcorr;
 463                 break;
 464 #endif /* BAYCOM_DEBUG */
 465
 466         }
 467         if (copy_to_user(ifr->ifr_data, &bi, sizeof(bi)))
 468                 return -EFAULT;
 469         return 0;
 470
 471 }
 472
 473 /* --------------------------------------------------------------------- */
 474
 475 /*
 476  * command line settable parameters
 477  */
 478 static char *mode[NR_PORTS] = { "picpar", };
 479 static int iobase[NR_PORTS] = { 0x378, };
 480
 481 module_param_array(mode, charp, NULL, 0);
 482 MODULE_PARM_DESC(mode, "baycom operating mode; eg. par96 or picpar");
 483 module_param_hw_array(iobase, int, ioport, NULL, 0);
 484 MODULE_PARM_DESC(iobase, "baycom io base address");
 485
 486 MODULE_AUTHOR("Thomas M. Sailer, sailer@ife.ee.ethz.ch, hb9jnx@hb9w.che.eu");
 487 MODULE_DESCRIPTION("Baycom par96 and picpar amateur radio modem driver");
 488 MODULE_LICENSE("GPL");
 489
 490 /* --------------------------------------------------------------------- */
 491
 492 static int baycom_par_probe(struct pardevice *par_dev)
 493 {
 494         struct device_driver *drv = par_dev->dev.driver;
 495         int len = strlen(drv->name);
 496
 497         if (strncmp(par_dev->name, drv->name, len))
 498                 return -ENODEV;
 499
 500         return 0;
 501 }
 502
 503 static struct parport_driver baycom_par_driver = {
 504         .name = "bcp",
 505         .probe = baycom_par_probe,
 506         .devmodel = true,
 507 };
 508
 509 static int __init init_baycompar(void)
 510 {
 511         int i, found = 0, ret;
 512         char set_hw = 1;
 513
 514         printk(bc_drvinfo);
 515
 516         ret = parport_register_driver(&baycom_par_driver);
 517         if (ret)
 518                 return ret;
 519
 520         /*
 521          * register net devices
 522          */
 523         for (i = 0; i < NR_PORTS; i++) {
 524                 struct net_device *dev;
 525                 struct baycom_state *bc;
 526                 char ifname[IFNAMSIZ];
 527
 528                 sprintf(ifname, "bcp%d", i);
 529
 530                 if (!mode[i])
 531                         set_hw = 0;
 532                 if (!set_hw)
 533                         iobase[i] = 0;
 534
 535                 dev = hdlcdrv_register(&par96_ops,
 536                                        sizeof(struct baycom_state),
 537                                        ifname, iobase[i], 0, 0);
 538                 if (IS_ERR(dev))
 539                         break;
 540
 541                 bc = netdev_priv(dev);
 542                 if (set_hw && baycom_setmode(bc, mode[i]))
 543                         set_hw = 0;
 544                 found++;
 545                 baycom_device[i] = dev;
 546         }
 547
 548         if (!found) {
 549                 parport_unregister_driver(&baycom_par_driver);
 550                 return -ENXIO;
 551         }
 552         return 0;
 553 }
 554
 555 static void __exit cleanup_baycompar(void)
 556 {
 557         int i;
 558
 559         for(i = 0; i < NR_PORTS; i++) {
 560                 struct net_device *dev = baycom_device[i];
 561
 562                 if (dev)
 563                         hdlcdrv_unregister(dev);
 564         }
 565         parport_unregister_driver(&baycom_par_driver);
 566 }
 567
 568 module_init(init_baycompar);
 569 module_exit(cleanup_baycompar);
 570
 571 /* --------------------------------------------------------------------- */
 572
 573 #ifndef MODULE
 574
 575 /*
 576  * format: baycom_par=io,mode
 577  * mode: par96,picpar
 578  */
 579
 580 static int __init baycom_par_setup(char *str)
 581 {
 582         static unsigned nr_dev;
 583         int ints[2];
 584
 585         if (nr_dev >= NR_PORTS)
 586                 return 0;
 587         str = get_options(str, 2, ints);
 588         if (ints[0] < 1)
 589                 return 0;
 590         mode[nr_dev] = str;
 591         iobase[nr_dev] = ints[1];
 592         nr_dev++;
 593         return 1;
 594 }
 595
 596 __setup("baycom_par=", baycom_par_setup);
 597
 598 #endif /* MODULE */
 599 /* --------------------------------------------------------------------- */