n2.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * SDL Inc. RISCom/N2 synchronous serial card driver for Linux
  4. *
  5. * Copyright (C) 1998-2003 Krzysztof Halasa <[email protected]>
  6. *
  7. * For information see <https://www.kernel.org/pub/linux/utils/net/hdlc/>
  8. *
  9. * Note: integrated CSU/DSU/DDS are not supported by this driver
  10. *
  11. * Sources of information:
  12. * Hitachi HD64570 SCA User's Manual
  13. * SDL Inc. PPP/HDLC/CISCO driver
  14. */
  15. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  16. #include <linux/module.h>
  17. #include <linux/kernel.h>
  18. #include <linux/capability.h>
  19. #include <linux/slab.h>
  20. #include <linux/types.h>
  21. #include <linux/fcntl.h>
  22. #include <linux/in.h>
  23. #include <linux/string.h>
  24. #include <linux/errno.h>
  25. #include <linux/init.h>
  26. #include <linux/ioport.h>
  27. #include <linux/moduleparam.h>
  28. #include <linux/netdevice.h>
  29. #include <linux/hdlc.h>
  30. #include <asm/io.h>
  31. #include "hd64570.h"
  32. static const char *version = "SDL RISCom/N2 driver version: 1.15";
  33. static const char *devname = "RISCom/N2";
  34. #undef DEBUG_PKT
  35. #define DEBUG_RINGS
  36. #define USE_WINDOWSIZE 16384
  37. #define USE_BUS16BITS 1
  38. #define CLOCK_BASE 9830400 /* 9.8304 MHz */
  39. #define MAX_PAGES 16 /* 16 RAM pages at max */
  40. #define MAX_RAM_SIZE 0x80000 /* 512 KB */
  41. #if MAX_RAM_SIZE > MAX_PAGES * USE_WINDOWSIZE
  42. #undef MAX_RAM_SIZE
  43. #define MAX_RAM_SIZE (MAX_PAGES * USE_WINDOWSIZE)
  44. #endif
  45. #define N2_IOPORTS 0x10
  46. #define NEED_DETECT_RAM
  47. #define NEED_SCA_MSCI_INTR
  48. #define MAX_TX_BUFFERS 10
  49. static char *hw; /* pointer to hw=xxx command line string */
  50. /* RISCom/N2 Board Registers */
  51. /* PC Control Register */
  52. #define N2_PCR 0
  53. #define PCR_RUNSCA 1 /* Run 64570 */
  54. #define PCR_VPM 2 /* Enable VPM - needed if using RAM above 1 MB */
  55. #define PCR_ENWIN 4 /* Open window */
  56. #define PCR_BUS16 8 /* 16-bit bus */
  57. /* Memory Base Address Register */
  58. #define N2_BAR 2
  59. /* Page Scan Register */
  60. #define N2_PSR 4
  61. #define WIN16K 0x00
  62. #define WIN32K 0x20
  63. #define WIN64K 0x40
  64. #define PSR_WINBITS 0x60
  65. #define PSR_DMAEN 0x80
  66. #define PSR_PAGEBITS 0x0F
  67. /* Modem Control Reg */
  68. #define N2_MCR 6
  69. #define CLOCK_OUT_PORT1 0x80
  70. #define CLOCK_OUT_PORT0 0x40
  71. #define TX422_PORT1 0x20
  72. #define TX422_PORT0 0x10
  73. #define DSR_PORT1 0x08
  74. #define DSR_PORT0 0x04
  75. #define DTR_PORT1 0x02
  76. #define DTR_PORT0 0x01
  77. typedef struct port_s {
  78. struct net_device *dev;
  79. struct card_s *card;
  80. spinlock_t lock; /* TX lock */
  81. sync_serial_settings settings;
  82. int valid; /* port enabled */
  83. int rxpart; /* partial frame received, next frame invalid*/
  84. unsigned short encoding;
  85. unsigned short parity;
  86. u16 rxin; /* rx ring buffer 'in' pointer */
  87. u16 txin; /* tx ring buffer 'in' and 'last' pointers */
  88. u16 txlast;
  89. u8 rxs, txs, tmc; /* SCA registers */
  90. u8 phy_node; /* physical port # - 0 or 1 */
  91. u8 log_node; /* logical port # */
  92. } port_t;
  93. typedef struct card_s {
  94. u8 __iomem *winbase; /* ISA window base address */
  95. u32 phy_winbase; /* ISA physical base address */
  96. u32 ram_size; /* number of bytes */
  97. u16 io; /* IO Base address */
  98. u16 buff_offset; /* offset of first buffer of first channel */
  99. u16 rx_ring_buffers; /* number of buffers in a ring */
  100. u16 tx_ring_buffers;
  101. u8 irq; /* IRQ (3-15) */
  102. port_t ports[2];
  103. struct card_s *next_card;
  104. } card_t;
  105. static card_t *first_card;
  106. static card_t **new_card = &first_card;
  107. #define sca_reg(reg, card) (0x8000 | (card)->io | \
  108. ((reg) & 0x0F) | (((reg) & 0xF0) << 6))
  109. #define sca_in(reg, card) inb(sca_reg(reg, card))
  110. #define sca_out(value, reg, card) outb(value, sca_reg(reg, card))
  111. #define sca_inw(reg, card) inw(sca_reg(reg, card))
  112. #define sca_outw(value, reg, card) outw(value, sca_reg(reg, card))
  113. #define port_to_card(port) ((port)->card)
  114. #define log_node(port) ((port)->log_node)
  115. #define phy_node(port) ((port)->phy_node)
  116. #define winsize(card) (USE_WINDOWSIZE)
  117. #define winbase(card) ((card)->winbase)
  118. #define get_port(card, port) ((card)->ports[port].valid ? \
  119. &(card)->ports[port] : NULL)
  120. static __inline__ u8 sca_get_page(card_t *card)
  121. {
  122. return inb(card->io + N2_PSR) & PSR_PAGEBITS;
  123. }
  124. static __inline__ void openwin(card_t *card, u8 page)
  125. {
  126. u8 psr = inb(card->io + N2_PSR);
  127. outb((psr & ~PSR_PAGEBITS) | page, card->io + N2_PSR);
  128. }
  129. #include "hd64570.c"
  130. static void n2_set_iface(port_t *port)
  131. {
  132. card_t *card = port->card;
  133. int io = card->io;
  134. u8 mcr = inb(io + N2_MCR);
  135. u8 msci = get_msci(port);
  136. u8 rxs = port->rxs & CLK_BRG_MASK;
  137. u8 txs = port->txs & CLK_BRG_MASK;
  138. switch (port->settings.clock_type) {
  139. case CLOCK_INT:
  140. mcr |= port->phy_node ? CLOCK_OUT_PORT1 : CLOCK_OUT_PORT0;
  141. rxs |= CLK_BRG_RX; /* BRG output */
  142. txs |= CLK_RXCLK_TX; /* RX clock */
  143. break;
  144. case CLOCK_TXINT:
  145. mcr |= port->phy_node ? CLOCK_OUT_PORT1 : CLOCK_OUT_PORT0;
  146. rxs |= CLK_LINE_RX; /* RXC input */
  147. txs |= CLK_BRG_TX; /* BRG output */
  148. break;
  149. case CLOCK_TXFROMRX:
  150. mcr |= port->phy_node ? CLOCK_OUT_PORT1 : CLOCK_OUT_PORT0;
  151. rxs |= CLK_LINE_RX; /* RXC input */
  152. txs |= CLK_RXCLK_TX; /* RX clock */
  153. break;
  154. default: /* Clock EXTernal */
  155. mcr &= port->phy_node ? ~CLOCK_OUT_PORT1 : ~CLOCK_OUT_PORT0;
  156. rxs |= CLK_LINE_RX; /* RXC input */
  157. txs |= CLK_LINE_TX; /* TXC input */
  158. }
  159. outb(mcr, io + N2_MCR);
  160. port->rxs = rxs;
  161. port->txs = txs;
  162. sca_out(rxs, msci + RXS, card);
  163. sca_out(txs, msci + TXS, card);
  164. sca_set_port(port);
  165. }
  166. static int n2_open(struct net_device *dev)
  167. {
  168. port_t *port = dev_to_port(dev);
  169. int io = port->card->io;
  170. u8 mcr = inb(io + N2_MCR) |
  171. (port->phy_node ? TX422_PORT1 : TX422_PORT0);
  172. int result;
  173. result = hdlc_open(dev);
  174. if (result)
  175. return result;
  176. mcr &= port->phy_node ? ~DTR_PORT1 : ~DTR_PORT0; /* set DTR ON */
  177. outb(mcr, io + N2_MCR);
  178. outb(inb(io + N2_PCR) | PCR_ENWIN, io + N2_PCR); /* open window */
  179. outb(inb(io + N2_PSR) | PSR_DMAEN, io + N2_PSR); /* enable dma */
  180. sca_open(dev);
  181. n2_set_iface(port);
  182. return 0;
  183. }
  184. static int n2_close(struct net_device *dev)
  185. {
  186. port_t *port = dev_to_port(dev);
  187. int io = port->card->io;
  188. u8 mcr = inb(io + N2_MCR) |
  189. (port->phy_node ? TX422_PORT1 : TX422_PORT0);
  190. sca_close(dev);
  191. mcr |= port->phy_node ? DTR_PORT1 : DTR_PORT0; /* set DTR OFF */
  192. outb(mcr, io + N2_MCR);
  193. hdlc_close(dev);
  194. return 0;
  195. }
  196. static int n2_siocdevprivate(struct net_device *dev, struct ifreq *ifr,
  197. void __user *data, int cmd)
  198. {
  199. #ifdef DEBUG_RINGS
  200. if (cmd == SIOCDEVPRIVATE) {
  201. sca_dump_rings(dev);
  202. return 0;
  203. }
  204. #endif
  205. return -EOPNOTSUPP;
  206. }
  207. static int n2_ioctl(struct net_device *dev, struct if_settings *ifs)
  208. {
  209. const size_t size = sizeof(sync_serial_settings);
  210. sync_serial_settings new_line;
  211. sync_serial_settings __user *line = ifs->ifs_ifsu.sync;
  212. port_t *port = dev_to_port(dev);
  213. switch (ifs->type) {
  214. case IF_GET_IFACE:
  215. ifs->type = IF_IFACE_SYNC_SERIAL;
  216. if (ifs->size < size) {
  217. ifs->size = size; /* data size wanted */
  218. return -ENOBUFS;
  219. }
  220. if (copy_to_user(line, &port->settings, size))
  221. return -EFAULT;
  222. return 0;
  223. case IF_IFACE_SYNC_SERIAL:
  224. if (!capable(CAP_NET_ADMIN))
  225. return -EPERM;
  226. if (copy_from_user(&new_line, line, size))
  227. return -EFAULT;
  228. if (new_line.clock_type != CLOCK_EXT &&
  229. new_line.clock_type != CLOCK_TXFROMRX &&
  230. new_line.clock_type != CLOCK_INT &&
  231. new_line.clock_type != CLOCK_TXINT)
  232. return -EINVAL; /* No such clock setting */
  233. if (new_line.loopback != 0 && new_line.loopback != 1)
  234. return -EINVAL;
  235. memcpy(&port->settings, &new_line, size); /* Update settings */
  236. n2_set_iface(port);
  237. return 0;
  238. default:
  239. return hdlc_ioctl(dev, ifs);
  240. }
  241. }
  242. static void n2_destroy_card(card_t *card)
  243. {
  244. int cnt;
  245. for (cnt = 0; cnt < 2; cnt++)
  246. if (card->ports[cnt].card) {
  247. struct net_device *dev = port_to_dev(&card->ports[cnt]);
  248. unregister_hdlc_device(dev);
  249. }
  250. if (card->irq)
  251. free_irq(card->irq, card);
  252. if (card->winbase) {
  253. iounmap(card->winbase);
  254. release_mem_region(card->phy_winbase, USE_WINDOWSIZE);
  255. }
  256. if (card->io)
  257. release_region(card->io, N2_IOPORTS);
  258. if (card->ports[0].dev)
  259. free_netdev(card->ports[0].dev);
  260. if (card->ports[1].dev)
  261. free_netdev(card->ports[1].dev);
  262. kfree(card);
  263. }
  264. static const struct net_device_ops n2_ops = {
  265. .ndo_open = n2_open,
  266. .ndo_stop = n2_close,
  267. .ndo_start_xmit = hdlc_start_xmit,
  268. .ndo_siocwandev = n2_ioctl,
  269. .ndo_siocdevprivate = n2_siocdevprivate,
  270. };
  271. static int __init n2_run(unsigned long io, unsigned long irq,
  272. unsigned long winbase, long valid0, long valid1)
  273. {
  274. card_t *card;
  275. u8 cnt, pcr;
  276. int i;
  277. if (io < 0x200 || io > 0x3FF || (io % N2_IOPORTS) != 0) {
  278. pr_err("invalid I/O port value\n");
  279. return -ENODEV;
  280. }
  281. if (irq < 3 || irq > 15 || irq == 6) /* FIXME */ {
  282. pr_err("invalid IRQ value\n");
  283. return -ENODEV;
  284. }
  285. if (winbase < 0xA0000 || winbase > 0xFFFFF || (winbase & 0xFFF) != 0) {
  286. pr_err("invalid RAM value\n");
  287. return -ENODEV;
  288. }
  289. card = kzalloc(sizeof(card_t), GFP_KERNEL);
  290. if (!card)
  291. return -ENOBUFS;
  292. card->ports[0].dev = alloc_hdlcdev(&card->ports[0]);
  293. card->ports[1].dev = alloc_hdlcdev(&card->ports[1]);
  294. if (!card->ports[0].dev || !card->ports[1].dev) {
  295. pr_err("unable to allocate memory\n");
  296. n2_destroy_card(card);
  297. return -ENOMEM;
  298. }
  299. if (!request_region(io, N2_IOPORTS, devname)) {
  300. pr_err("I/O port region in use\n");
  301. n2_destroy_card(card);
  302. return -EBUSY;
  303. }
  304. card->io = io;
  305. if (request_irq(irq, sca_intr, 0, devname, card)) {
  306. pr_err("could not allocate IRQ\n");
  307. n2_destroy_card(card);
  308. return -EBUSY;
  309. }
  310. card->irq = irq;
  311. if (!request_mem_region(winbase, USE_WINDOWSIZE, devname)) {
  312. pr_err("could not request RAM window\n");
  313. n2_destroy_card(card);
  314. return -EBUSY;
  315. }
  316. card->phy_winbase = winbase;
  317. card->winbase = ioremap(winbase, USE_WINDOWSIZE);
  318. if (!card->winbase) {
  319. pr_err("ioremap() failed\n");
  320. n2_destroy_card(card);
  321. return -EFAULT;
  322. }
  323. outb(0, io + N2_PCR);
  324. outb(winbase >> 12, io + N2_BAR);
  325. switch (USE_WINDOWSIZE) {
  326. case 16384:
  327. outb(WIN16K, io + N2_PSR);
  328. break;
  329. case 32768:
  330. outb(WIN32K, io + N2_PSR);
  331. break;
  332. case 65536:
  333. outb(WIN64K, io + N2_PSR);
  334. break;
  335. default:
  336. pr_err("invalid window size\n");
  337. n2_destroy_card(card);
  338. return -ENODEV;
  339. }
  340. pcr = PCR_ENWIN | PCR_VPM | (USE_BUS16BITS ? PCR_BUS16 : 0);
  341. outb(pcr, io + N2_PCR);
  342. card->ram_size = sca_detect_ram(card, card->winbase, MAX_RAM_SIZE);
  343. /* number of TX + RX buffers for one port */
  344. i = card->ram_size / ((valid0 + valid1) * (sizeof(pkt_desc) +
  345. HDLC_MAX_MRU));
  346. card->tx_ring_buffers = min(i / 2, MAX_TX_BUFFERS);
  347. card->rx_ring_buffers = i - card->tx_ring_buffers;
  348. card->buff_offset = (valid0 + valid1) * sizeof(pkt_desc) *
  349. (card->tx_ring_buffers + card->rx_ring_buffers);
  350. pr_info("RISCom/N2 %u KB RAM, IRQ%u, using %u TX + %u RX packets rings\n",
  351. card->ram_size / 1024, card->irq,
  352. card->tx_ring_buffers, card->rx_ring_buffers);
  353. if (card->tx_ring_buffers < 1) {
  354. pr_err("RAM test failed\n");
  355. n2_destroy_card(card);
  356. return -EIO;
  357. }
  358. pcr |= PCR_RUNSCA; /* run SCA */
  359. outb(pcr, io + N2_PCR);
  360. outb(0, io + N2_MCR);
  361. sca_init(card, 0);
  362. for (cnt = 0; cnt < 2; cnt++) {
  363. port_t *port = &card->ports[cnt];
  364. struct net_device *dev = port_to_dev(port);
  365. hdlc_device *hdlc = dev_to_hdlc(dev);
  366. if ((cnt == 0 && !valid0) || (cnt == 1 && !valid1))
  367. continue;
  368. port->phy_node = cnt;
  369. port->valid = 1;
  370. if ((cnt == 1) && valid0)
  371. port->log_node = 1;
  372. spin_lock_init(&port->lock);
  373. dev->irq = irq;
  374. dev->mem_start = winbase;
  375. dev->mem_end = winbase + USE_WINDOWSIZE - 1;
  376. dev->tx_queue_len = 50;
  377. dev->netdev_ops = &n2_ops;
  378. hdlc->attach = sca_attach;
  379. hdlc->xmit = sca_xmit;
  380. port->settings.clock_type = CLOCK_EXT;
  381. port->card = card;
  382. if (register_hdlc_device(dev)) {
  383. pr_warn("unable to register hdlc device\n");
  384. port->card = NULL;
  385. n2_destroy_card(card);
  386. return -ENOBUFS;
  387. }
  388. sca_init_port(port); /* Set up SCA memory */
  389. netdev_info(dev, "RISCom/N2 node %d\n", port->phy_node);
  390. }
  391. *new_card = card;
  392. new_card = &card->next_card;
  393. return 0;
  394. }
  395. static int __init n2_init(void)
  396. {
  397. if (!hw) {
  398. #ifdef MODULE
  399. pr_info("no card initialized\n");
  400. #endif
  401. return -EINVAL; /* no parameters specified, abort */
  402. }
  403. pr_info("%s\n", version);
  404. do {
  405. unsigned long io, irq, ram;
  406. long valid[2] = { 0, 0 }; /* Default = both ports disabled */
  407. io = simple_strtoul(hw, &hw, 0);
  408. if (*hw++ != ',')
  409. break;
  410. irq = simple_strtoul(hw, &hw, 0);
  411. if (*hw++ != ',')
  412. break;
  413. ram = simple_strtoul(hw, &hw, 0);
  414. if (*hw++ != ',')
  415. break;
  416. while (1) {
  417. if (*hw == '0' && !valid[0])
  418. valid[0] = 1; /* Port 0 enabled */
  419. else if (*hw == '1' && !valid[1])
  420. valid[1] = 1; /* Port 1 enabled */
  421. else
  422. break;
  423. hw++;
  424. }
  425. if (!valid[0] && !valid[1])
  426. break; /* at least one port must be used */
  427. if (*hw == ':' || *hw == '\x0')
  428. n2_run(io, irq, ram, valid[0], valid[1]);
  429. if (*hw == '\x0')
  430. return first_card ? 0 : -EINVAL;
  431. } while (*hw++ == ':');
  432. pr_err("invalid hardware parameters\n");
  433. return first_card ? 0 : -EINVAL;
  434. }
  435. static void __exit n2_cleanup(void)
  436. {
  437. card_t *card = first_card;
  438. while (card) {
  439. card_t *ptr = card;
  440. card = card->next_card;
  441. n2_destroy_card(ptr);
  442. }
  443. }
  444. module_init(n2_init);
  445. module_exit(n2_cleanup);
  446. MODULE_AUTHOR("Krzysztof Halasa <[email protected]>");
  447. MODULE_DESCRIPTION("RISCom/N2 serial port driver");
  448. MODULE_LICENSE("GPL v2");
  449. module_param(hw, charp, 0444);
  450. MODULE_PARM_DESC(hw, "io,irq,ram,ports:io,irq,...");