[serial] Add general abstraction of a 16550-compatible UART

Signed-off-by: Michael Brown <mcb30@ipxe.org>
This commit is contained in:
Michael Brown
2015-06-29 08:39:58 +01:00
parent edf74df4ab
commit 611c9e39da
6 changed files with 371 additions and 0 deletions

View File

@@ -0,0 +1,62 @@
/*
* Copyright (C) 2014 Michael Brown <mbrown@fensystems.co.uk>.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or any later version.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301, USA.
*
* You can also choose to distribute this program under the terms of
* the Unmodified Binary Distribution Licence (as given in the file
* COPYING.UBDL), provided that you have satisfied its requirements.
*/
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
/** @file
*
* 16550-compatible UART
*
*/
#include <errno.h>
#include <ipxe/uart.h>
/** UART port bases */
static uint16_t uart_base[] = {
[COM1] = 0x3f8,
[COM2] = 0x2f8,
[COM3] = 0x3e8,
[COM4] = 0x2e8,
};
/**
* Select UART port
*
* @v uart UART
* @v port Port number, or 0 to disable
* @ret rc Return status code
*/
int uart_select ( struct uart *uart, unsigned int port ) {
/* Clear UART base */
uart->base = NULL;
/* Set new UART base */
if ( port < ( sizeof ( uart_base ) / sizeof ( uart_base[0] ) ) ) {
uart->base = ( ( void * ) ( intptr_t ) uart_base[port] );
return 0;
} else {
return -ENODEV;
}
}

View File

@@ -48,6 +48,7 @@ FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
#define ERRFILE_timer_bios ( ERRFILE_ARCH | ERRFILE_DRIVER | 0x00010000 )
#define ERRFILE_hvm ( ERRFILE_ARCH | ERRFILE_DRIVER | 0x00020000 )
#define ERRFILE_hyperv ( ERRFILE_ARCH | ERRFILE_DRIVER | 0x00030000 )
#define ERRFILE_x86_uart ( ERRFILE_ARCH | ERRFILE_DRIVER | 0x00040000 )
#define ERRFILE_cpuid_cmd ( ERRFILE_ARCH | ERRFILE_OTHER | 0x00000000 )
#define ERRFILE_cpuid_settings ( ERRFILE_ARCH | ERRFILE_OTHER | 0x00010000 )

View File

@@ -0,0 +1,41 @@
#ifndef _BITS_UART_H
#define _BITS_UART_H
/** @file
*
* 16550-compatible UART
*
*/
FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
#include <stdint.h>
#include <ipxe/io.h>
/**
* Write to UART register
*
* @v uart UART
* @v addr Register address
* @v data Data
*/
static inline __attribute__ (( always_inline )) void
uart_write ( struct uart *uart, unsigned int addr, uint8_t data ) {
outb ( data, ( uart->base + addr ) );
}
/**
* Read from UART register
*
* @v uart UART
* @v addr Register address
* @ret data Data
*/
static inline __attribute__ (( always_inline )) uint8_t
uart_read ( struct uart *uart, unsigned int addr ) {
return inb ( uart->base + addr );
}
extern int uart_select ( struct uart *uart, unsigned int port );
#endif /* _BITS_UART_H */