Commit 1ab92da3 authored by Okash Khawaja's avatar Okash Khawaja Committed by Greg Kroah-Hartman
Browse files

staging: speakup: add tty-based comms functions 



This adds spk_ttyio.c file. It contains a set of functions which implement
those methods in spk_synth struct which relate to sending bytes out using
serial comms. Implementations in this file perform the same function but
using TTY subsystem instead. Currently synths access serial ports, directly
poking standard ISA ports by trying to steal them from serial driver. Some ISA
cards actually need this way of doing it, but most other synthesizers don't,
and can actually work by using the proper TTY subsystem through a new N_SPEAKUP
line discipline. So this adds the methods for drivers to switch to accessing
serial ports through the TTY subsystem, whenever appropriate.

Signed-off-by: default avatarOkash Khawaja <okash.khawaja@gmail.com>
Reviewed-by: default avatarSamuel Thibault <samuel.thibault@ens-lyon.org>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 12e84c71

drivers/staging/speakup/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -25,6 +25,7 @@ speakup-y := \ 
	kobjects.o \

	selection.o \

	serialio.o \

	spk_ttyio.o \

	synth.o \

	thread.o \

	varhandlers.o

drivers/staging/speakup/spk_priv.h

+4 −0
Original line number Diff line number Diff line
@@ -44,6 +44,7 @@ const struct old_serial_port *spk_serial_init(int index); 
void spk_stop_serial_interrupt(void);

int spk_wait_for_xmitr(struct spk_synth *in_synth);

void spk_serial_release(void);

void spk_ttyio_release(void);



void synth_buffer_skip_nonlatin1(void);

u16 synth_buffer_getc(void);
@@ -56,7 +57,9 @@ ssize_t spk_var_store(struct kobject *kobj, struct kobj_attribute *attr, 
		      const char *buf, size_t count);



int spk_serial_synth_probe(struct spk_synth *synth);

int spk_ttyio_synth_probe(struct spk_synth *synth);

const char *spk_serial_synth_immediate(struct spk_synth *synth, const char *buff);

const char *spk_ttyio_synth_immediate(struct spk_synth *synth, const char *buff);

void spk_do_catch_up(struct spk_synth *synth);

void spk_synth_flush(struct spk_synth *synth);

unsigned char spk_synth_get_index(struct spk_synth *synth);
@@ -78,5 +81,6 @@ extern struct speakup_info_t speakup_info; 
extern struct var_t synth_time_vars[];



extern struct spk_io_ops spk_serial_io_ops;

extern struct spk_io_ops spk_ttyio_ops;



#endif

drivers/staging/speakup/spk_ttyio.c

0 → 100644
+143 −0
Original line number Diff line number Diff line 
#include <linux/types.h>

#include <linux/tty.h>



#include "speakup.h"

#include "spk_types.h"



static struct tty_struct *speakup_tty;



static int spk_ttyio_ldisc_open(struct tty_struct *tty)

{

	if (tty->ops->write == NULL)

		return -EOPNOTSUPP;

	speakup_tty = tty;



	return 0;

}



static void spk_ttyio_ldisc_close(struct tty_struct *tty)

{

	speakup_tty = NULL;

}



static struct tty_ldisc_ops spk_ttyio_ldisc_ops = {

	.owner          = THIS_MODULE,

	.magic          = TTY_LDISC_MAGIC,

	.name           = "speakup_ldisc",

	.open           = spk_ttyio_ldisc_open,

	.close          = spk_ttyio_ldisc_close,

};



static int spk_ttyio_out(struct spk_synth *in_synth, const char ch);

struct spk_io_ops spk_ttyio_ops = {

	.synth_out = spk_ttyio_out,

};

EXPORT_SYMBOL_GPL(spk_ttyio_ops);



static int spk_ttyio_initialise_ldisc(int ser)

{

	int ret = 0;

	struct tty_struct *tty;



	ret = tty_register_ldisc(N_SPEAKUP, &spk_ttyio_ldisc_ops);

	if (ret) {

		pr_err("Error registering line discipline.\n");

		return ret;

	}



	if (ser < 0 || ser > (255 - 64)) {

		pr_err("speakup: Invalid ser param. Must be between 0 and 191 inclusive.\n");

		return -EINVAL;

	}



	/* TODO: support more than ttyS* */

	tty = tty_open_by_driver(MKDEV(4, (ser +  64)), NULL, NULL);

	if (IS_ERR(tty))

		return PTR_ERR(tty);



	if (tty->ops->open)

		ret = tty->ops->open(tty, NULL);

	else

		ret = -ENODEV;



	if (ret) {

		tty_unlock(tty);

		return ret;

	}



	clear_bit(TTY_HUPPED, &tty->flags);

	tty_unlock(tty);



	ret = tty_set_ldisc(tty, N_SPEAKUP);



	return ret;

}



static int spk_ttyio_out(struct spk_synth *in_synth, const char ch)

{

	if (in_synth->alive && speakup_tty && speakup_tty->ops->write) {

		int ret = speakup_tty->ops->write(speakup_tty, &ch, 1);

		if (ret == 0)

			/* No room */

			return 0;

		if (ret < 0) {

			pr_warn("%s: I/O error, deactivating speakup\n", in_synth->long_name);

			/* No synth any more, so nobody will restart TTYs, and we thus

			 * need to do it ourselves.  Now that there is no synth we can

			 * let application flood anyway

			 */

			in_synth->alive = 0;

			speakup_start_ttys();

			return 0;

		}

		return 1;

	}

	return 0;

}



int spk_ttyio_synth_probe(struct spk_synth *synth)

{

	int rv = spk_ttyio_initialise_ldisc(synth->ser);



	if (rv)

		return rv;



	synth->alive = 1;



	return 0;

}

EXPORT_SYMBOL_GPL(spk_ttyio_synth_probe);



void spk_ttyio_release(void)

{

	int idx;



	if (!speakup_tty)

		return;



	tty_lock(speakup_tty);

	idx = speakup_tty->index;



	if (speakup_tty->ops->close)

		speakup_tty->ops->close(speakup_tty, NULL);



	tty_ldisc_flush(speakup_tty);

	tty_unlock(speakup_tty);

	tty_ldisc_release(speakup_tty);

}

EXPORT_SYMBOL_GPL(spk_ttyio_release);



const char *spk_ttyio_synth_immediate(struct spk_synth *synth, const char *buff)

{

	u_char ch;



	while ((ch = *buff)) {

		if (ch == '\n')

			ch = synth->procspeech;

		if (tty_write_room(speakup_tty) < 1 || !synth->io_ops->synth_out(synth, ch))

			return buff;

		buff++;

	}

	return NULL;

}

EXPORT_SYMBOL_GPL(spk_ttyio_synth_immediate);

drivers/tty/tty_ldisc.c

+2 −0
Original line number Diff line number Diff line
@@ -605,6 +605,7 @@ err: 
	tty_unlock(tty);

	return retval;

}

EXPORT_SYMBOL_GPL(tty_set_ldisc);



/**

 *	tty_ldisc_kill	-	teardown ldisc
@@ -797,6 +798,7 @@ void tty_ldisc_release(struct tty_struct *tty) 


	tty_ldisc_debug(tty, "released\n");

}

EXPORT_SYMBOL_GPL(tty_ldisc_release);



/**

 *	tty_ldisc_init		-	ldisc setup for new tty

include/uapi/linux/tty.h

+1 −0
Original line number Diff line number Diff line
@@ -35,5 +35,6 @@ 
#define N_TRACESINK	23	/* Trace data routing for MIPI P1149.7 */

#define N_TRACEROUTER	24	/* Trace data routing for MIPI P1149.7 */

#define N_NCI		25	/* NFC NCI UART */

#define N_SPEAKUP	26	/* Speakup communication with synths */



#endif /* _UAPI_LINUX_TTY_H */

CRA Git | Maintained and supported by SUSTech CRA and CCSE