baycom_par.c 17 KB

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