summaryrefslogblamecommitdiffstats
path: root/c/src/lib/libbsp/m68k/mcf5235/console/console.c
blob: acf6daab544c0761f9ea73baed5746f7fccaa9ab (plain) (tree)
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799












































































































                                                                                   


                                                                    














































































































































































































































































































































































































































































































































































































































































































                                                                                                               
 /*
  *  Multi UART console serial I/O.
  *
  * TO DO: Add DMA input/output
  */

#include <stdio.h>
#include <fcntl.h>
#include <rtems/libio.h>
#include <rtems/termiostypes.h>
#include <termios.h>
#include <bsp.h>
#include <malloc.h>
#include <rtems/mw_uid.h>

#include <rtems/bspIo.h>

#define UART_INTC0_IRQ_VECTOR(x) (64+13+(x))

#define MCF5235_UART_USR_ERROR ( MCF5235_UART_USR_RB | \
                                 MCF5235_UART_USR_FE | \
                                 MCF5235_UART_USR_PE | \
                                 MCF5235_UART_USR_OE )

static int IntUartPollWrite(int minor, const char *buf, int len);
static int IntUartInterruptWrite (int minor, const char *buf, int len);

static void
_BSP_null_char( char c )
{ 
	int level;

    if (c == '\n')
        _BSP_null_char('\r');
	rtems_interrupt_disable(level);
    while ( (MCF5235_UART_USR(CONSOLE_PORT) & MCF5235_UART_USR_TXRDY) == 0 )
        continue;
    MCF5235_UART_UTB(CONSOLE_PORT) = c;
    while ( (MCF5235_UART_USR(CONSOLE_PORT) & MCF5235_UART_USR_TXRDY) == 0 )
        continue;
	rtems_interrupt_enable(level);
}
BSP_output_char_function_type BSP_output_char = _BSP_null_char;

#define MAX_UART_INFO     3
#define RX_BUFFER_SIZE    512

struct IntUartInfoStruct
{
	int                    iomode;
	volatile int           uimr;
	int                    baud;
	int                    databits;
	int                    parity;
	int                    stopbits;
	int                    hwflow;
	int                    rx_in;
	int                    rx_out;
	char                   rx_buffer[RX_BUFFER_SIZE];
	void                  *ttyp;
};

struct IntUartInfoStruct IntUartInfo[MAX_UART_INFO];

static int GetBaud( int baudHandle )
{
	int baud = 9600;
	switch ( baudHandle )
	{
		case B0:
			baud = (int)0;
			break;
		case B1200:
			baud = (int)1200;
			break;
		case B2400:
			baud = (int)2400;
			break;
		case B4800:
			baud = (int)4800;
			break;
		case B9600:
			baud = (int)9600;
			break;
		case B19200:
			baud = (int)19200;
			break;
		case B38400:
			baud = (int)38400;
			break;
		case B57600:
			baud = (int)57600;
			break;
		case B115200:
			baud = (int)115200;
			break;
	}
	return ( baud );
}

/***************************************************************************
   Function : IntUartSet

   Description : This updates the hardware UART settings.
 ***************************************************************************/
static void
IntUartSet(int minor, int baud, int databits, int parity, int stopbits, int hwflow)
{
	int                         divisor;
	uint32_t					clock_speed;
	uint8_t                   umr1 = 0;
	uint8_t                   umr2 = 0;
	struct IntUartInfoStruct   *info = &IntUartInfo[minor];
	int                         level;

	rtems_interrupt_disable(level);


	/* disable interrupts, clear RTS line, and disable the UARTS */
	MCF5235_UART_UIMR(minor) = 0;
	MCF5235_UART_UOP0(minor) = 1;
	MCF5235_UART_UCR(minor) = (MCF5235_UART_UCR_TX_DISABLED | MCF5235_UART_UCR_RX_DISABLED);

	/* save the current values */
	info->uimr     = 0;
	info->baud     = baud;
	info->databits = databits;
	info->parity   = parity;
	info->stopbits = stopbits;
	info->hwflow   = hwflow;

    clock_speed = get_CPU_clock_speed();
    /* determine the baud divisor value */
    divisor = ((clock_speed/2) / ( 32 * baud ));
    if ( divisor < 2 )
        divisor = 2;

	/* check to see if doing hardware flow control */
	if ( hwflow )
	{
		/* set hardware flow options */
		umr1 |= MCF5235_UART_UMR_RXRTS;
		umr2 |= MCF5235_UART_UMR_TXCTS;
	}

	/* determine the new umr values */
	umr1 |= (parity | databits);
	umr2 |= (stopbits);

	/* reset the uart */
	MCF5235_UART_UCR(minor) = MCF5235_UART_UCR_RESET_ERROR;
	MCF5235_UART_UCR(minor) = MCF5235_UART_UCR_RESET_RX;
	MCF5235_UART_UCR(minor) = MCF5235_UART_UCR_RESET_TX;

	/* reset the uart mode register and update values */
	MCF5235_UART_UCR(minor) = MCF5235_UART_UCR_RESET_MR;
	MCF5235_UART_UMR(minor) = umr1;
	MCF5235_UART_UMR(minor) = umr2;

	/* set the baud rate values */
	MCF5235_UART_UCSR(minor) = (MCF5235_UART_UCSR_RCS_SYS_CLK | MCF5235_UART_UCSR_TCS_SYS_CLK);
	MCF5235_UART_UBG1(minor) = (divisor & 0xff00) >> 8;
	MCF5235_UART_UBG2(minor) = (divisor & 0x00ff);

	/* enable the uart */
    MCF5235_UART_UCR(minor) = (MCF5235_UART_UCR_TX_ENABLED | MCF5235_UART_UCR_RX_ENABLED);

	/* check to see if interrupts need to be enabled */
	if ( info->iomode != TERMIOS_POLLED )
	{
		/* enable rx interrupts */
		info->uimr |= MCF5235_UART_UIMR_FFULL;
		MCF5235_UART_UIMR(minor) = info->uimr;
	}

	/* check to see if doing hardware flow control */
	if ( hwflow )
	{
		/* assert the RTS line */
		MCF5235_UART_UOP1(minor) = 1;
	}

	rtems_interrupt_enable(level);

}


/***************************************************************************
   Function : IntUartSetAttributes

   Description : This provides the hardware-dependent portion of tcsetattr().
   value and sets it. At the moment this just sets the baud rate.

   Note: The highest baudrate is 115200 as this stays within 
   an error of +/- 5% at 25MHz processor clock
 ***************************************************************************/
static int
IntUartSetAttributes(int minor, const struct termios *t)
{
	/* set default index values */
	int                         baud     = (int)19200;
	int                         databits = (int)MCF5235_UART_UMR_BC_8;
	int                         parity   = (int)MCF5235_UART_UMR_PM_NONE;
	int                         stopbits = (int)MCF5235_UART_UMR_STOP_BITS_1;
	int                         hwflow   = (int)0;
	struct IntUartInfoStruct   *info     = &IntUartInfo[minor];

	/* check to see if input is valid */
	if ( t != (const struct termios *)0 )
	{
		/* determine baud rate index */
		baud = GetBaud( t->c_cflag & CBAUD );

		/* determine data bits */
		switch ( t->c_cflag & CSIZE )
		{
			case CS5:
				databits = (int)MCF5235_UART_UMR_BC_5;
				break;
			case CS6:
				databits = (int)MCF5235_UART_UMR_BC_6;
				break;
			case CS7:
				databits = (int)MCF5235_UART_UMR_BC_7;
				break;
			case CS8:
				databits = (int)MCF5235_UART_UMR_BC_8;
				break;
		}

		/* determine if parity is enabled */
		if ( t->c_cflag & PARENB )
		{
			if ( t->c_cflag & PARODD )
			{
				/* odd parity */
				parity = (int)MCF5235_UART_UMR_PM_ODD;
			}
			else
			{
				/* even parity */
				parity = (int)MCF5235_UART_UMR_PM_EVEN;
			}
		}

		/* determine stop bits */
		if ( t->c_cflag & CSTOPB )
		{
			/* two stop bits */
			stopbits = (int)MCF5235_UART_UMR_STOP_BITS_2;
		}

		/* check to see if hardware flow control */
		if ( t->c_cflag & CRTSCTS )
		{
			hwflow = 1;
		}
	}

	/* check to see if values have changed */
	if ( ( baud     != info->baud     ) ||
		 ( databits != info->databits ) ||
		 ( parity   != info->parity   ) ||
		 ( stopbits != info->stopbits ) ||
		 ( hwflow   != info->hwflow   ) )
	{

		/* call function to set values */
		IntUartSet(minor, baud, databits, parity, stopbits, hwflow);
	}

	return( RTEMS_SUCCESSFUL );

}

/***************************************************************************
   Function : IntUartInterruptHandler

   Description : This is the interrupt handler for the internal uart. It
   determines which channel caused the interrupt before queueing any received
   chars and dequeueing chars waiting for transmission.
 ***************************************************************************/
static rtems_isr
IntUartInterruptHandler(rtems_vector_number v)
{
	unsigned int                chan = v - UART_INTC0_IRQ_VECTOR(0);
	struct IntUartInfoStruct   *info = &IntUartInfo[chan];

	/* check to see if received data */
	if ( MCF5235_UART_UISR(chan) & MCF5235_UART_UISR_RXRDY )
	{
		/* read data and put into the receive buffer */
		while ( MCF5235_UART_USR(chan) & MCF5235_UART_USR_RXRDY )
		{

			if ( MCF5235_UART_USR(chan) & MCF5235_UART_USR_ERROR )
			{
				/* clear the error */
				MCF5235_UART_UCR(chan) = MCF5235_UART_UCR_RESET_ERROR;
			}
			/* put data in rx buffer and check for errors */
			info->rx_buffer[info->rx_in] = MCF5235_UART_URB(chan);

			/* update buffer values */
			info->rx_in++;

			if ( info->rx_in >= RX_BUFFER_SIZE )
			{
				info->rx_in = 0;
			}
		}
		/* Make sure the port has been opened */
		if ( info->ttyp )
		{

			/* check to see if task driven */
			if ( info->iomode == TERMIOS_TASK_DRIVEN )
			{
				/* notify rx task that rx buffer has data */
				rtems_termios_rxirq_occured(info->ttyp);
			}
			else
			{
				/* Push up the received data */
				rtems_termios_enqueue_raw_characters(info->ttyp, info->rx_buffer, info->rx_in);
				info->rx_in    = 0;
			}
		}
	}

	/* check to see if data needs to be transmitted */
	if ( ( info->uimr & MCF5235_UART_UIMR_TXRDY ) &&
		 ( MCF5235_UART_UISR(chan) & MCF5235_UART_UISR_TXRDY ) )
	{

		/* disable tx interrupts */
		info->uimr &= ~MCF5235_UART_UIMR_TXRDY;
		MCF5235_UART_UIMR(chan) = info->uimr;

		/* tell upper level that character has been sent */
		if ( info->ttyp )
			rtems_termios_dequeue_characters(info->ttyp, 1);
	}
}



/***************************************************************************
   Function : IntUartInitialize

   Description : This initialises the internal uart hardware for all
   internal uarts. If the internal uart is to be interrupt driven then the
   interrupt vectors are hooked.
 ***************************************************************************/
static void
IntUartInitialize(void)
{
	unsigned int        chan;
	struct IntUartInfoStruct   *info;
	rtems_isr_entry old_handler;
    int level;

	for ( chan = 0; chan < MAX_UART_INFO; chan++ )
	{
		info = &IntUartInfo[chan];

		info->ttyp     = NULL;
		info->rx_in    = 0;
		info->rx_out   = 0;
		info->baud     = -1;
		info->databits = -1;
		info->parity   = -1;
		info->stopbits = -1;
		info->hwflow   = -1;
		info->iomode   = TERMIOS_POLLED; //polled console io

		MCF5235_UART_UACR(chan) = 0;
		MCF5235_UART_UIMR(chan) = 0;
		if ( info->iomode != TERMIOS_POLLED )
		{
			rtems_interrupt_catch (IntUartInterruptHandler,
								   UART_INTC0_IRQ_VECTOR(chan),
								   &old_handler);
		}

		/* set uart default values */
		IntUartSetAttributes(chan, NULL);

        /* unmask interrupt */
		rtems_interrupt_disable(level);
        switch(chan) {
        case 0:
            MCF5235_INTC0_ICR13 = MCF5235_INTC_ICR_IL(UART0_IRQ_LEVEL) |
                                  MCF5235_INTC_ICR_IP(UART0_IRQ_PRIORITY);
            MCF5235_INTC0_IMRL &= ~(MCF5235_INTC0_IMRL_INT13 |
                                    MCF5235_INTC0_IMRL_MASKALL);
            break;

        case 1:
            MCF5235_INTC0_ICR14 = MCF5235_INTC_ICR_IL(UART1_IRQ_LEVEL) |
                                  MCF5235_INTC_ICR_IP(UART1_IRQ_PRIORITY);
            MCF5235_INTC0_IMRL &= ~(MCF5235_INTC0_IMRL_INT14 |
                                    MCF5235_INTC0_IMRL_MASKALL);
            break;

        case 2:
            MCF5235_INTC0_ICR15 = MCF5235_INTC_ICR_IL(UART2_IRQ_LEVEL) |
                                  MCF5235_INTC_ICR_IP(UART2_IRQ_PRIORITY);
            MCF5235_INTC0_IMRL &= ~(MCF5235_INTC0_IMRL_INT15 |
                                    MCF5235_INTC0_IMRL_MASKALL);
            break;
        }
		rtems_interrupt_enable(level);

	} /* of chan loop */


} /* IntUartInitialise */


/***************************************************************************
   Function : IntUartInterruptWrite

   Description : This writes a single character to the appropriate uart 
   channel. This is either called during an interrupt or in the user's task
   to initiate a transmit sequence. Calling this routine enables Tx 
   interrupts.
 ***************************************************************************/
static int
IntUartInterruptWrite (int minor, const char *buf, int len)
{
	int level;

	rtems_interrupt_disable(level);

	/* write out character */
	MCF5235_UART_UTB(minor) = *buf;

	/* enable tx interrupt */
	IntUartInfo[minor].uimr |= MCF5235_UART_UIMR_TXRDY;
	MCF5235_UART_UIMR(minor) = IntUartInfo[minor].uimr;

	rtems_interrupt_enable(level);
	return( 0 );
}

/***************************************************************************
   Function : IntUartInterruptOpen

   Description : This enables interrupts when the tty is opened.
 ***************************************************************************/
static int
IntUartInterruptOpen(int major, int minor, void *arg)
{
	struct IntUartInfoStruct   *info = &IntUartInfo[minor];

	/* enable the uart */
	MCF5235_UART_UCR(minor) = (MCF5235_UART_UCR_TX_ENABLED | MCF5235_UART_UCR_RX_ENABLED);

	/* check to see if interrupts need to be enabled */
	if ( info->iomode != TERMIOS_POLLED )
	{
		/* enable rx interrupts */
		info->uimr |= MCF5235_UART_UIMR_FFULL;
		MCF5235_UART_UIMR(minor) = info->uimr;
	}

	/* check to see if doing hardware flow control */
	if ( info->hwflow )
	{
		/* assert the RTS line */
		MCF5235_UART_UOP1(minor) = 1;
	}

	return( 0 );
}



/***************************************************************************
   Function : IntUartInterruptClose

   Description : This disables interrupts when the tty is closed.
 ***************************************************************************/
static int
IntUartInterruptClose(int major, int minor, void *arg)
{
	struct IntUartInfoStruct   *info = &IntUartInfo[minor];

	/* disable the interrupts and the uart */
	MCF5235_UART_UIMR(minor) = 0;
	MCF5235_UART_UCR(minor) = (MCF5235_UART_UCR_TX_DISABLED | MCF5235_UART_UCR_RX_DISABLED);

	/* reset values */
	info->ttyp     = NULL;
	info->uimr       = 0;
	info->rx_in    = 0;
	info->rx_out   = 0;

	return( 0 );
}

/***************************************************************************
   Function : IntUartTaskRead

   Description : This reads all available characters from the internal uart
   and places them into the termios buffer.  The rx interrupts will be
   re-enabled after all data has been read.
 ***************************************************************************/
static int
IntUartTaskRead(int minor)
{
	char                        buffer[RX_BUFFER_SIZE];
	int                         count;
	int                         rx_in;
	int                         index = 0;
	struct IntUartInfoStruct   *info  = &IntUartInfo[minor];

	/* determine number of values to copy out */
	rx_in = info->rx_in;
	if ( info->rx_out <= rx_in )
	{
		count = rx_in - info->rx_out;
	}
	else
	{
		count = (RX_BUFFER_SIZE - info->rx_out) + rx_in;
	}

	/* copy data into local buffer from rx buffer */
	while ( ( index < count ) && ( index < RX_BUFFER_SIZE ) )
	{
		/* copy data byte */ 
		buffer[index] = info->rx_buffer[info->rx_out];
		index++;

		/* increment rx buffer values */
		info->rx_out++;
		if ( info->rx_out >= RX_BUFFER_SIZE )
		{
			info->rx_out = 0;
		}
	}

	/* check to see if buffer is not empty */
	if ( count > 0 )
	{
		/* set characters into termios buffer  */
		rtems_termios_enqueue_raw_characters(info->ttyp, buffer, count);
	}

	return( EOF );
}



/***************************************************************************
   Function : IntUartPollRead

   Description : This reads a character from the internal uart. It returns 
   to the caller without blocking if not character is waiting.
 ***************************************************************************/
static int
IntUartPollRead (int minor)
{
	if ( (MCF5235_UART_USR(minor) & MCF5235_UART_USR_RXRDY) == 0 )
		return(-1);

	return(MCF5235_UART_URB(minor));
}


/***************************************************************************
   Function : IntUartPollWrite

   Description : This writes out each character in the buffer to the 
   appropriate internal uart channel waiting till each one is sucessfully 
   transmitted.
 ***************************************************************************/
static int
IntUartPollWrite (int minor, const char *buf, int len)
{
	/* loop over buffer */
	while ( len-- )
	{
		/* block until we can transmit */
		while ( (MCF5235_UART_USR(minor) & MCF5235_UART_USR_TXRDY) == 0 )
			continue;
		/* transmit data byte */
		MCF5235_UART_UTB(minor) = *buf++;
	}
	return(0);
}

/***************************************************************************
   Function : console_reserve_resources

   Description : This reserves resources consumed by this driver. It passes
   the request on to the termios subsystem.
 ***************************************************************************/
void console_reserve_resources( rtems_configuration_table *configuration )
{
	rtems_termios_reserve_resources (configuration, 1);
}


/***************************************************************************
   Function : console_initialize

   Description : This initialises termios, both sets of uart hardware before
   registering /dev/tty devices for each channel and the system /dev/console.
 ***************************************************************************/
rtems_device_driver console_initialize(
	rtems_device_major_number  major,
	rtems_device_minor_number  minor,
	void  *arg )
{
	rtems_status_code status;


	/* Set up TERMIOS */
	rtems_termios_initialize ();

	/* set io modes for the different channels and initialize device */
    IntUartInfo[minor].iomode = TERMIOS_IRQ_DRIVEN;
	IntUartInitialize(); 

	/* Register the console port */
	status = rtems_io_register_name ("/dev/console", major, CONSOLE_PORT);
	if ( status != RTEMS_SUCCESSFUL )
	{
		rtems_fatal_error_occurred (status);
	}

	/* Register the other port */
	if ( CONSOLE_PORT != 0 )
	{
		status = rtems_io_register_name ("/dev/tty00", major, 0);
		if ( status != RTEMS_SUCCESSFUL )
		{
			rtems_fatal_error_occurred (status);
		}
	}
	if ( CONSOLE_PORT != 1 )
	{
		status = rtems_io_register_name ("/dev/tty01", major, 1);
		if ( status != RTEMS_SUCCESSFUL )
		{
			rtems_fatal_error_occurred (status);
		}
	}

	return(RTEMS_SUCCESSFUL);
}

/***************************************************************************
   Function : console_open

   Description : This actually opens the device depending on the minor 
   number set during initialisation. The device specific access routines are
   passed to termios when the devices is opened depending on whether it is
   polled or not.
 ***************************************************************************/
rtems_device_driver console_open(
	rtems_device_major_number major,
	rtems_device_minor_number minor,
	void  * arg)
{
	rtems_status_code                status = RTEMS_INVALID_NUMBER;
	rtems_libio_open_close_args_t   *args   = (rtems_libio_open_close_args_t *)arg;
	struct IntUartInfoStruct        *info;

	static const rtems_termios_callbacks IntUartPollCallbacks = {
		NULL,				  /* firstOpen */
		NULL,				  /* lastClose */
		IntUartPollRead,	  /* pollRead */
		IntUartPollWrite,	  /* write */
		IntUartSetAttributes, /* setAttributes */
		NULL,				  /* stopRemoteTx */
		NULL,				  /* startRemoteTx */
		TERMIOS_POLLED		  /* mode */
	};
	static const rtems_termios_callbacks IntUartIntrCallbacks = {
		IntUartInterruptOpen,  /* firstOpen */
		IntUartInterruptClose, /* lastClose */
		NULL,				   /* pollRead */
		IntUartInterruptWrite, /* write */
		IntUartSetAttributes,  /* setAttributes */
		NULL,				   /* stopRemoteTx */
		NULL,				   /* startRemoteTx */
		TERMIOS_IRQ_DRIVEN	   /* mode */
	};

	static const rtems_termios_callbacks IntUartTaskCallbacks = {
		IntUartInterruptOpen,  /* firstOpen */
		IntUartInterruptClose, /* lastClose */
		IntUartTaskRead,	   /* pollRead */
		IntUartInterruptWrite, /* write */
		IntUartSetAttributes,  /* setAttributes */
		NULL,				   /* stopRemoteTx */
		NULL,				   /* startRemoteTx */
		TERMIOS_TASK_DRIVEN	   /* mode */
	};

	/* open the port depending on the minor device number */
	if ( ( minor >= 0 ) && ( minor < MAX_UART_INFO ) )
	{
		info = &IntUartInfo[minor];
		switch ( info->iomode )
		{
			case TERMIOS_POLLED:
				status = rtems_termios_open(major, minor, arg, &IntUartPollCallbacks);
				break;
			case TERMIOS_IRQ_DRIVEN:
				status = rtems_termios_open(major, minor, arg, &IntUartIntrCallbacks);
				info->ttyp = args->iop->data1;
				break;
			case TERMIOS_TASK_DRIVEN:
				status = rtems_termios_open(major, minor, arg, &IntUartTaskCallbacks);
				info->ttyp = args->iop->data1;
				break;
		}
	}

	return( status );
}

/***************************************************************************
   Function : console_close

   Description : This closes the device via termios
 ***************************************************************************/
rtems_device_driver console_close(
	rtems_device_major_number major,
	rtems_device_minor_number minor,
	void   * arg)
{
    return(rtems_termios_close (arg));
}

/******************
*********************************************************
   Function : console_read

   Description : Read from the device via termios
 ***************************************************************************/
rtems_device_driver console_read(
	rtems_device_major_number major,
	rtems_device_minor_number minor,
	void  * arg)
{
    return(rtems_termios_read (arg));
}

/***************************************************************************
   Function : console_write

   Description : Write to the device via termios
 ***************************************************************************/
rtems_device_driver console_write(
	rtems_device_major_number major,
	rtems_device_minor_number minor,
	void  * arg)
{
    return(rtems_termios_write (arg));
}

/***************************************************************************
   Function : console_ioctl

   Description : Pass the IOCtl call to termios
 ***************************************************************************/
rtems_device_driver console_control(
	rtems_device_major_number major,
	rtems_device_minor_number minor,
	void  * arg)
{
    return( rtems_termios_ioctl (arg) );
}
int DEBUG_OUTCHAR(int c)
{
    if(c == '\n')
        DEBUG_OUTCHAR('\r');
    _BSP_null_char(c);
    return c;
}
void DEBUG_OUTSTR(const char *msg)
{
    while (*msg)
        DEBUG_OUTCHAR(*msg++);
}
void DEBUG_OUTNUM(int i)
{
    int n;
    static const char map[] = "0123456789ABCDEF";
    DEBUG_OUTCHAR(' ');
    for (n = 28 ; n >= 0 ; n -= 4)
        DEBUG_OUTCHAR(map[(i >> n) & 0xF]);
}