2 * drivers/s390/char/sclp_vt220.c
3 * SCLP VT220 terminal driver.
6 * Copyright IBM Corp. 2003,2008
7 * Author(s): Peter Oberparleiter <Peter.Oberparleiter@de.ibm.com>
10 #include <linux/module.h>
11 #include <linux/spinlock.h>
12 #include <linux/list.h>
13 #include <linux/wait.h>
14 #include <linux/timer.h>
15 #include <linux/kernel.h>
16 #include <linux/tty.h>
17 #include <linux/tty_driver.h>
18 #include <linux/tty_flip.h>
19 #include <linux/errno.h>
21 #include <linux/major.h>
22 #include <linux/console.h>
23 #include <linux/kdev_t.h>
24 #include <linux/bootmem.h>
25 #include <linux/interrupt.h>
26 #include <linux/init.h>
27 #include <linux/reboot.h>
29 #include <asm/uaccess.h>
32 #define SCLP_VT220_MAJOR TTY_MAJOR
33 #define SCLP_VT220_MINOR 65
34 #define SCLP_VT220_DRIVER_NAME "sclp_vt220"
35 #define SCLP_VT220_DEVICE_NAME "ttysclp"
36 #define SCLP_VT220_CONSOLE_NAME "ttyS"
37 #define SCLP_VT220_CONSOLE_INDEX 1 /* console=ttyS1 */
38 #define SCLP_VT220_BUF_SIZE 80
40 /* Representation of a single write request */
41 struct sclp_vt220_request {
42 struct list_head list;
43 struct sclp_req sclp_req;
48 struct sclp_vt220_sccb {
49 struct sccb_header header;
50 struct evbuf_header evbuf;
53 #define SCLP_VT220_MAX_CHARS_PER_BUFFER (PAGE_SIZE - \
54 sizeof(struct sclp_vt220_request) - \
55 sizeof(struct sclp_vt220_sccb))
57 /* Structures and data needed to register tty driver */
58 static struct tty_driver *sclp_vt220_driver;
60 /* The tty_struct that the kernel associated with us */
61 static struct tty_struct *sclp_vt220_tty;
63 /* Lock to protect internal data from concurrent access */
64 static spinlock_t sclp_vt220_lock;
66 /* List of empty pages to be used as write request buffers */
67 static struct list_head sclp_vt220_empty;
69 /* List of pending requests */
70 static struct list_head sclp_vt220_outqueue;
72 /* Number of requests in outqueue */
73 static int sclp_vt220_outqueue_count;
75 /* Timer used for delaying write requests to merge subsequent messages into
77 static struct timer_list sclp_vt220_timer;
79 /* Pointer to current request buffer which has been partially filled but not
81 static struct sclp_vt220_request *sclp_vt220_current_request;
83 /* Number of characters in current request buffer */
84 static int sclp_vt220_buffered_chars;
86 /* Counter controlling core driver initialization. */
87 static int __initdata sclp_vt220_init_count;
89 /* Flag indicating that sclp_vt220_current_request should really
90 * have been already queued but wasn't because the SCLP was processing
92 static int sclp_vt220_flush_later;
94 static void sclp_vt220_receiver_fn(struct evbuf_header *evbuf);
95 static int __sclp_vt220_emit(struct sclp_vt220_request *request);
96 static void sclp_vt220_emit_current(void);
98 /* Registration structure for our interest in SCLP event buffers */
99 static struct sclp_register sclp_vt220_register = {
100 .send_mask = EVTYP_VT220MSG_MASK,
101 .receive_mask = EVTYP_VT220MSG_MASK,
102 .state_change_fn = NULL,
103 .receiver_fn = sclp_vt220_receiver_fn
108 * Put provided request buffer back into queue and check emit pending
109 * buffers if necessary.
112 sclp_vt220_process_queue(struct sclp_vt220_request *request)
118 /* Put buffer back to list of empty buffers */
119 page = request->sclp_req.sccb;
120 spin_lock_irqsave(&sclp_vt220_lock, flags);
121 /* Move request from outqueue to empty queue */
122 list_del(&request->list);
123 sclp_vt220_outqueue_count--;
124 list_add_tail((struct list_head *) page, &sclp_vt220_empty);
125 /* Check if there is a pending buffer on the out queue. */
127 if (!list_empty(&sclp_vt220_outqueue))
128 request = list_entry(sclp_vt220_outqueue.next,
129 struct sclp_vt220_request, list);
130 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
131 } while (request && __sclp_vt220_emit(request));
132 if (request == NULL && sclp_vt220_flush_later)
133 sclp_vt220_emit_current();
134 /* Check if the tty needs a wake up call */
135 if (sclp_vt220_tty != NULL) {
136 tty_wakeup(sclp_vt220_tty);
140 #define SCLP_BUFFER_MAX_RETRY 1
143 * Callback through which the result of a write request is reported by the
147 sclp_vt220_callback(struct sclp_req *request, void *data)
149 struct sclp_vt220_request *vt220_request;
150 struct sclp_vt220_sccb *sccb;
152 vt220_request = (struct sclp_vt220_request *) data;
153 if (request->status == SCLP_REQ_FAILED) {
154 sclp_vt220_process_queue(vt220_request);
157 sccb = (struct sclp_vt220_sccb *) vt220_request->sclp_req.sccb;
159 /* Check SCLP response code and choose suitable action */
160 switch (sccb->header.response_code) {
164 case 0x05f0: /* Target resource in improper state */
167 case 0x0340: /* Contained SCLP equipment check */
168 if (++vt220_request->retry_count > SCLP_BUFFER_MAX_RETRY)
170 /* Remove processed buffers and requeue rest */
171 if (sclp_remove_processed((struct sccb_header *) sccb) > 0) {
172 /* Not all buffers were processed */
173 sccb->header.response_code = 0x0000;
174 vt220_request->sclp_req.status = SCLP_REQ_FILLED;
175 if (sclp_add_request(request) == 0)
180 case 0x0040: /* SCLP equipment check */
181 if (++vt220_request->retry_count > SCLP_BUFFER_MAX_RETRY)
183 sccb->header.response_code = 0x0000;
184 vt220_request->sclp_req.status = SCLP_REQ_FILLED;
185 if (sclp_add_request(request) == 0)
192 sclp_vt220_process_queue(vt220_request);
196 * Emit vt220 request buffer to SCLP. Return zero on success, non-zero
200 __sclp_vt220_emit(struct sclp_vt220_request *request)
202 if (!(sclp_vt220_register.sclp_receive_mask & EVTYP_VT220MSG_MASK)) {
203 request->sclp_req.status = SCLP_REQ_FAILED;
206 request->sclp_req.command = SCLP_CMDW_WRITE_EVENT_DATA;
207 request->sclp_req.status = SCLP_REQ_FILLED;
208 request->sclp_req.callback = sclp_vt220_callback;
209 request->sclp_req.callback_data = (void *) request;
211 return sclp_add_request(&request->sclp_req);
215 * Queue and emit given request.
218 sclp_vt220_emit(struct sclp_vt220_request *request)
223 spin_lock_irqsave(&sclp_vt220_lock, flags);
224 list_add_tail(&request->list, &sclp_vt220_outqueue);
225 count = sclp_vt220_outqueue_count++;
226 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
227 /* Emit only the first buffer immediately - callback takes care of
229 if (count == 0 && __sclp_vt220_emit(request))
230 sclp_vt220_process_queue(request);
234 * Queue and emit current request. Return zero on success, non-zero otherwise.
237 sclp_vt220_emit_current(void)
240 struct sclp_vt220_request *request;
241 struct sclp_vt220_sccb *sccb;
243 spin_lock_irqsave(&sclp_vt220_lock, flags);
245 if (sclp_vt220_current_request != NULL) {
246 sccb = (struct sclp_vt220_sccb *)
247 sclp_vt220_current_request->sclp_req.sccb;
248 /* Only emit buffers with content */
249 if (sccb->header.length != sizeof(struct sclp_vt220_sccb)) {
250 request = sclp_vt220_current_request;
251 sclp_vt220_current_request = NULL;
252 if (timer_pending(&sclp_vt220_timer))
253 del_timer(&sclp_vt220_timer);
255 sclp_vt220_flush_later = 0;
257 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
259 sclp_vt220_emit(request);
262 #define SCLP_NORMAL_WRITE 0x00
265 * Helper function to initialize a page with the sclp request structure.
267 static struct sclp_vt220_request *
268 sclp_vt220_initialize_page(void *page)
270 struct sclp_vt220_request *request;
271 struct sclp_vt220_sccb *sccb;
273 /* Place request structure at end of page */
274 request = ((struct sclp_vt220_request *)
275 ((addr_t) page + PAGE_SIZE)) - 1;
276 request->retry_count = 0;
277 request->sclp_req.sccb = page;
278 /* SCCB goes at start of page */
279 sccb = (struct sclp_vt220_sccb *) page;
280 memset((void *) sccb, 0, sizeof(struct sclp_vt220_sccb));
281 sccb->header.length = sizeof(struct sclp_vt220_sccb);
282 sccb->header.function_code = SCLP_NORMAL_WRITE;
283 sccb->header.response_code = 0x0000;
284 sccb->evbuf.type = EVTYP_VT220MSG;
285 sccb->evbuf.length = sizeof(struct evbuf_header);
290 static inline unsigned int
291 sclp_vt220_space_left(struct sclp_vt220_request *request)
293 struct sclp_vt220_sccb *sccb;
294 sccb = (struct sclp_vt220_sccb *) request->sclp_req.sccb;
295 return PAGE_SIZE - sizeof(struct sclp_vt220_request) -
299 static inline unsigned int
300 sclp_vt220_chars_stored(struct sclp_vt220_request *request)
302 struct sclp_vt220_sccb *sccb;
303 sccb = (struct sclp_vt220_sccb *) request->sclp_req.sccb;
304 return sccb->evbuf.length - sizeof(struct evbuf_header);
308 * Add msg to buffer associated with request. Return the number of characters
312 sclp_vt220_add_msg(struct sclp_vt220_request *request,
313 const unsigned char *msg, int count, int convertlf)
315 struct sclp_vt220_sccb *sccb;
321 if (count > sclp_vt220_space_left(request))
322 count = sclp_vt220_space_left(request);
326 sccb = (struct sclp_vt220_sccb *) request->sclp_req.sccb;
327 buffer = (void *) ((addr_t) sccb + sccb->header.length);
330 /* Perform Linefeed conversion (0x0a -> 0x0a 0x0d)*/
332 (from < count) && (to < sclp_vt220_space_left(request));
334 /* Retrieve character */
336 /* Perform conversion */
338 if (to + 1 < sclp_vt220_space_left(request)) {
339 ((unsigned char *) buffer)[to++] = c;
340 ((unsigned char *) buffer)[to++] = 0x0d;
345 ((unsigned char *) buffer)[to++] = c;
347 sccb->header.length += to;
348 sccb->evbuf.length += to;
351 memcpy(buffer, (const void *) msg, count);
352 sccb->header.length += count;
353 sccb->evbuf.length += count;
359 * Emit buffer after having waited long enough for more data to arrive.
362 sclp_vt220_timeout(unsigned long data)
364 sclp_vt220_emit_current();
367 #define BUFFER_MAX_DELAY HZ/20
370 * Internal implementation of the write function. Write COUNT bytes of data
372 * to the SCLP interface. In case that the data does not fit into the current
373 * write buffer, emit the current one and allocate a new one. If there are no
374 * more empty buffers available, wait until one gets emptied. If DO_SCHEDULE
375 * is non-zero, the buffer will be scheduled for emitting after a timeout -
376 * otherwise the user has to explicitly call the flush function.
377 * A non-zero CONVERTLF parameter indicates that 0x0a characters in the message
378 * buffer should be converted to 0x0a 0x0d. After completion, return the number
382 __sclp_vt220_write(const unsigned char *buf, int count, int do_schedule,
383 int convertlf, int may_fail)
393 spin_lock_irqsave(&sclp_vt220_lock, flags);
395 /* Create an sclp output buffer if none exists yet */
396 if (sclp_vt220_current_request == NULL) {
397 while (list_empty(&sclp_vt220_empty)) {
398 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
403 spin_lock_irqsave(&sclp_vt220_lock, flags);
405 page = (void *) sclp_vt220_empty.next;
406 list_del((struct list_head *) page);
407 sclp_vt220_current_request =
408 sclp_vt220_initialize_page(page);
410 /* Try to write the string to the current request buffer */
411 written = sclp_vt220_add_msg(sclp_vt220_current_request,
412 buf, count, convertlf);
413 overall_written += written;
414 if (written == count)
417 * Not all characters could be written to the current
418 * output buffer. Emit the buffer, create a new buffer
419 * and then output the rest of the string.
421 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
422 sclp_vt220_emit_current();
423 spin_lock_irqsave(&sclp_vt220_lock, flags);
427 /* Setup timer to output current console buffer after some time */
428 if (sclp_vt220_current_request != NULL &&
429 !timer_pending(&sclp_vt220_timer) && do_schedule) {
430 sclp_vt220_timer.function = sclp_vt220_timeout;
431 sclp_vt220_timer.data = 0UL;
432 sclp_vt220_timer.expires = jiffies + BUFFER_MAX_DELAY;
433 add_timer(&sclp_vt220_timer);
435 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
437 return overall_written;
441 * This routine is called by the kernel to write a series of
442 * characters to the tty device. The characters may come from
443 * user space or kernel space. This routine will return the
444 * number of characters actually accepted for writing.
447 sclp_vt220_write(struct tty_struct *tty, const unsigned char *buf, int count)
449 return __sclp_vt220_write(buf, count, 1, 0, 1);
452 #define SCLP_VT220_SESSION_ENDED 0x01
453 #define SCLP_VT220_SESSION_STARTED 0x80
454 #define SCLP_VT220_SESSION_DATA 0x00
457 * Called by the SCLP to report incoming event buffers.
460 sclp_vt220_receiver_fn(struct evbuf_header *evbuf)
465 /* Ignore input if device is not open */
466 if (sclp_vt220_tty == NULL)
469 buffer = (char *) ((addr_t) evbuf + sizeof(struct evbuf_header));
470 count = evbuf->length - sizeof(struct evbuf_header);
473 case SCLP_VT220_SESSION_ENDED:
474 case SCLP_VT220_SESSION_STARTED:
476 case SCLP_VT220_SESSION_DATA:
477 /* Send input to line discipline */
480 tty_insert_flip_string(sclp_vt220_tty, buffer, count);
481 tty_flip_buffer_push(sclp_vt220_tty);
487 * This routine is called when a particular tty device is opened.
490 sclp_vt220_open(struct tty_struct *tty, struct file *filp)
492 if (tty->count == 1) {
493 sclp_vt220_tty = tty;
494 tty->driver_data = kmalloc(SCLP_VT220_BUF_SIZE, GFP_KERNEL);
495 if (tty->driver_data == NULL)
497 tty->low_latency = 0;
503 * This routine is called when a particular tty device is closed.
506 sclp_vt220_close(struct tty_struct *tty, struct file *filp)
508 if (tty->count == 1) {
509 sclp_vt220_tty = NULL;
510 kfree(tty->driver_data);
511 tty->driver_data = NULL;
516 * This routine is called by the kernel to write a single
517 * character to the tty device. If the kernel uses this routine,
518 * it must call the flush_chars() routine (if defined) when it is
519 * done stuffing characters into the driver.
522 sclp_vt220_put_char(struct tty_struct *tty, unsigned char ch)
524 return __sclp_vt220_write(&ch, 1, 0, 0, 1);
528 * This routine is called by the kernel after it has written a
529 * series of characters to the tty device using put_char().
532 sclp_vt220_flush_chars(struct tty_struct *tty)
534 if (sclp_vt220_outqueue_count == 0)
535 sclp_vt220_emit_current();
537 sclp_vt220_flush_later = 1;
541 * This routine returns the numbers of characters the tty driver
542 * will accept for queuing to be written. This number is subject
543 * to change as output buffers get emptied, or if the output flow
547 sclp_vt220_write_room(struct tty_struct *tty)
553 spin_lock_irqsave(&sclp_vt220_lock, flags);
555 if (sclp_vt220_current_request != NULL)
556 count = sclp_vt220_space_left(sclp_vt220_current_request);
557 list_for_each(l, &sclp_vt220_empty)
558 count += SCLP_VT220_MAX_CHARS_PER_BUFFER;
559 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
564 * Return number of buffered chars.
567 sclp_vt220_chars_in_buffer(struct tty_struct *tty)
571 struct sclp_vt220_request *r;
574 spin_lock_irqsave(&sclp_vt220_lock, flags);
576 if (sclp_vt220_current_request != NULL)
577 count = sclp_vt220_chars_stored(sclp_vt220_current_request);
578 list_for_each(l, &sclp_vt220_outqueue) {
579 r = list_entry(l, struct sclp_vt220_request, list);
580 count += sclp_vt220_chars_stored(r);
582 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
587 * Pass on all buffers to the hardware. Return only when there are no more
591 sclp_vt220_flush_buffer(struct tty_struct *tty)
593 sclp_vt220_emit_current();
596 /* Release allocated pages. */
597 static void __init __sclp_vt220_free_pages(void)
599 struct list_head *page, *p;
601 list_for_each_safe(page, p, &sclp_vt220_empty) {
603 if (slab_is_available())
604 free_page((unsigned long) page);
606 free_bootmem((unsigned long) page, PAGE_SIZE);
610 /* Release memory and unregister from sclp core. Controlled by init counting -
611 * only the last invoker will actually perform these actions. */
612 static void __init __sclp_vt220_cleanup(void)
614 sclp_vt220_init_count--;
615 if (sclp_vt220_init_count != 0)
617 sclp_unregister(&sclp_vt220_register);
618 __sclp_vt220_free_pages();
621 /* Allocate buffer pages and register with sclp core. Controlled by init
622 * counting - only the first invoker will actually perform these actions. */
623 static int __init __sclp_vt220_init(int num_pages)
629 sclp_vt220_init_count++;
630 if (sclp_vt220_init_count != 1)
632 spin_lock_init(&sclp_vt220_lock);
633 INIT_LIST_HEAD(&sclp_vt220_empty);
634 INIT_LIST_HEAD(&sclp_vt220_outqueue);
635 init_timer(&sclp_vt220_timer);
636 sclp_vt220_current_request = NULL;
637 sclp_vt220_buffered_chars = 0;
638 sclp_vt220_outqueue_count = 0;
639 sclp_vt220_tty = NULL;
640 sclp_vt220_flush_later = 0;
642 /* Allocate pages for output buffering */
643 for (i = 0; i < num_pages; i++) {
644 if (slab_is_available())
645 page = (void *) get_zeroed_page(GFP_KERNEL | GFP_DMA);
647 page = alloc_bootmem_low_pages(PAGE_SIZE);
652 list_add_tail((struct list_head *) page, &sclp_vt220_empty);
654 rc = sclp_register(&sclp_vt220_register);
657 __sclp_vt220_free_pages();
658 sclp_vt220_init_count--;
663 static const struct tty_operations sclp_vt220_ops = {
664 .open = sclp_vt220_open,
665 .close = sclp_vt220_close,
666 .write = sclp_vt220_write,
667 .put_char = sclp_vt220_put_char,
668 .flush_chars = sclp_vt220_flush_chars,
669 .write_room = sclp_vt220_write_room,
670 .chars_in_buffer = sclp_vt220_chars_in_buffer,
671 .flush_buffer = sclp_vt220_flush_buffer,
675 * Register driver with SCLP and Linux and initialize internal tty structures.
677 static int __init sclp_vt220_tty_init(void)
679 struct tty_driver *driver;
682 /* Note: we're not testing for CONSOLE_IS_SCLP here to preserve
683 * symmetry between VM and LPAR systems regarding ttyS1. */
684 driver = alloc_tty_driver(1);
687 rc = __sclp_vt220_init(MAX_KMEM_PAGES);
691 driver->owner = THIS_MODULE;
692 driver->driver_name = SCLP_VT220_DRIVER_NAME;
693 driver->name = SCLP_VT220_DEVICE_NAME;
694 driver->major = SCLP_VT220_MAJOR;
695 driver->minor_start = SCLP_VT220_MINOR;
696 driver->type = TTY_DRIVER_TYPE_SYSTEM;
697 driver->subtype = SYSTEM_TYPE_TTY;
698 driver->init_termios = tty_std_termios;
699 driver->flags = TTY_DRIVER_REAL_RAW;
700 tty_set_operations(driver, &sclp_vt220_ops);
702 rc = tty_register_driver(driver);
705 sclp_vt220_driver = driver;
709 __sclp_vt220_cleanup();
711 put_tty_driver(driver);
714 __initcall(sclp_vt220_tty_init);
716 #ifdef CONFIG_SCLP_VT220_CONSOLE
719 sclp_vt220_con_write(struct console *con, const char *buf, unsigned int count)
721 __sclp_vt220_write((const unsigned char *) buf, count, 1, 1, 0);
724 static struct tty_driver *
725 sclp_vt220_con_device(struct console *c, int *index)
728 return sclp_vt220_driver;
731 static void __sclp_vt220_flush_buffer(void)
735 sclp_vt220_emit_current();
736 spin_lock_irqsave(&sclp_vt220_lock, flags);
737 if (timer_pending(&sclp_vt220_timer))
738 del_timer(&sclp_vt220_timer);
739 while (sclp_vt220_outqueue_count > 0) {
740 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
742 spin_lock_irqsave(&sclp_vt220_lock, flags);
744 spin_unlock_irqrestore(&sclp_vt220_lock, flags);
748 sclp_vt220_notify(struct notifier_block *self,
749 unsigned long event, void *data)
751 __sclp_vt220_flush_buffer();
755 static struct notifier_block on_panic_nb = {
756 .notifier_call = sclp_vt220_notify,
760 static struct notifier_block on_reboot_nb = {
761 .notifier_call = sclp_vt220_notify,
765 /* Structure needed to register with printk */
766 static struct console sclp_vt220_console =
768 .name = SCLP_VT220_CONSOLE_NAME,
769 .write = sclp_vt220_con_write,
770 .device = sclp_vt220_con_device,
771 .flags = CON_PRINTBUFFER,
772 .index = SCLP_VT220_CONSOLE_INDEX
776 sclp_vt220_con_init(void)
780 if (!CONSOLE_IS_SCLP)
782 rc = __sclp_vt220_init(MAX_CONSOLE_PAGES);
785 /* Attach linux console */
786 atomic_notifier_chain_register(&panic_notifier_list, &on_panic_nb);
787 register_reboot_notifier(&on_reboot_nb);
788 register_console(&sclp_vt220_console);
792 console_initcall(sclp_vt220_con_init);
793 #endif /* CONFIG_SCLP_VT220_CONSOLE */