/* SPDX-License-Identifier: BSD-2-Clause */ /** * @file * * @ingroup RTEMSBSPsMicroblaze * * @brief MicroBlaze AXI UART Lite support */ /* * Copyright (C) 2021 On-Line Applications Research Corporation (OAR) * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ #include #include #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS static void microblaze_uart_interrupt( void *arg ) { rtems_termios_tty *tty = arg; uart_lite_context *ctx = rtems_termios_get_device_context( tty ); while ( !XUartLite_IsReceiveEmpty( ctx->address ) ) { char c = (char) XUartLite_ReadReg( ctx->address, XUL_RX_FIFO_OFFSET ); rtems_termios_enqueue_raw_characters( tty, &c, 1 ); } while ( ctx->transmitting && !XUartLite_IsTransmitEmpty( ctx ) ) { rtems_termios_dequeue_characters( tty, 1 ); } } #endif static bool uart_first_open( struct rtems_termios_tty *tty, rtems_termios_device_context *base, struct termios *term, rtems_libio_open_close_args_t *args ) { uart_lite_context *ctx = (uart_lite_context *) base; #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS rtems_status_code sc; #endif rtems_termios_set_initial_baud( tty, ctx->initial_baud ); #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS XUartLite_EnableIntr( ctx->address ); sc = rtems_interrupt_handler_install( 1, "UART", RTEMS_INTERRUPT_SHARED, microblaze_uart_interrupt, tty ); if ( sc != RTEMS_SUCCESSFUL ) { return false; } #endif return true; } static void uart_last_close( rtems_termios_tty *tty, rtems_termios_device_context *base, rtems_libio_open_close_args_t *args ) { #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS rtems_interrupt_handler_remove( 1, microblaze_uart_interrupt, tty ); #endif } #ifndef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS static int uart_read_polled( rtems_termios_device_context *base ) { uart_lite_context *ctx = (uart_lite_context *) base; if ( XUartLite_IsReceiveEmpty( ctx->address ) ) { return -1; } return XUartLite_ReadReg( ctx->address, XUL_RX_FIFO_OFFSET ); } #endif static void uart_write( rtems_termios_device_context *base, const char *s, size_t n ) { uart_lite_context *ctx = (uart_lite_context *) base; #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS if ( n > 0 ) { ctx->transmitting = true; XUartLite_SendByte( ctx->address, s[0] ); } else { ctx->transmitting = false; } #else size_t i = 0; for ( i = 0; i < n; ++i ) { XUartLite_SendByte( ctx->address, s[i] ); } #endif } const rtems_termios_device_handler microblaze_uart_fns = { .first_open = uart_first_open, .last_close = uart_last_close, .write = uart_write, #ifdef BSP_MICROBLAZE_FPGA_CONSOLE_INTERRUPTS .mode = TERMIOS_IRQ_DRIVEN #else .poll_read = uart_read_polled, .mode = TERMIOS_POLLED #endif };