mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-08-17 18:07:01 +02:00
09d40e0e08
Enforce full include path for includes. Deprecate old paths.
The following folders inside include/lib have been left unchanged:
- include/lib/cpus/${ARCH}
- include/lib/el3_runtime/${ARCH}
The reason for this change is that having a global namespace for
includes isn't a good idea. It defeats one of the advantages of having
folders and it introduces problems that are sometimes subtle (because
you may not know the header you are actually including if there are two
of them).
For example, this patch had to be created because two headers were
called the same way: e0ea0928d5 ("Fix gpio includes of mt8173 platform
to avoid collision."). More recently, this patch has had similar
problems: 46f9b2c3a2 ("drivers: add tzc380 support").
This problem was introduced in commit 4ecca33988 ("Move include and
source files to logical locations"). At that time, there weren't too
many headers so it wasn't a real issue. However, time has shown that
this creates problems.
Platforms that want to preserve the way they include headers may add the
removed paths to PLAT_INCLUDES, but this is discouraged.
Change-Id: I39dc53ed98f9e297a5966e723d1936d6ccf2fc8f
Signed-off-by: Antonio Nino Diaz <antonio.ninodiaz@arm.com>
97 lines
3.1 KiB
C
97 lines
3.1 KiB
C
/*
|
|
* Copyright (c) 2015-2018, ARM Limited and Contributors. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef UART_16550_H
|
|
#define UART_16550_H
|
|
|
|
#include <drivers/console.h>
|
|
|
|
/* UART16550 Registers */
|
|
#define UARTTX 0x0
|
|
#define UARTRX 0x0
|
|
#define UARTDLL 0x0
|
|
#define UARTIER 0x4
|
|
#define UARTDLLM 0x4
|
|
#define UARTIIR 0x8
|
|
#define UARTFCR 0x8
|
|
#define UARTLCR 0xc
|
|
#define UARTMCR 0x10
|
|
#define UARTLSR 0x14
|
|
#define UARTMSR 0x18
|
|
#define UARTSPR 0x1c
|
|
#define UARTCSR 0x20
|
|
/* Some instances have MDR1 defined as well */
|
|
#define UARTMDR1 0x20
|
|
#define UARTRXFIFOCFG 0x24
|
|
#define UARTMIE 0x28
|
|
#define UARTVNDR 0x2c
|
|
#define UARTASR 0x3c
|
|
|
|
/* FIFO Control Register bits */
|
|
#define UARTFCR_FIFOMD_16450 (0 << 6)
|
|
#define UARTFCR_FIFOMD_16550 (1 << 6)
|
|
#define UARTFCR_RXTRIG_1 (0 << 6)
|
|
#define UARTFCR_RXTRIG_4 (1 << 6)
|
|
#define UARTFCR_RXTRIG_8 (2 << 6)
|
|
#define UARTFCR_RXTRIG_16 (3 << 6)
|
|
#define UARTFCR_TXTRIG_1 (0 << 4)
|
|
#define UARTFCR_TXTRIG_4 (1 << 4)
|
|
#define UARTFCR_TXTRIG_8 (2 << 4)
|
|
#define UARTFCR_TXTRIG_16 (3 << 4)
|
|
#define UARTFCR_DMAEN (1 << 3) /* Enable DMA mode */
|
|
#define UARTFCR_TXCLR (1 << 2) /* Clear contents of Tx FIFO */
|
|
#define UARTFCR_RXCLR (1 << 1) /* Clear contents of Rx FIFO */
|
|
#define UARTFCR_FIFOEN (1 << 0) /* Enable the Tx/Rx FIFO */
|
|
|
|
/* Line Control Register bits */
|
|
#define UARTLCR_DLAB (1 << 7) /* Divisor Latch Access */
|
|
#define UARTLCR_SETB (1 << 6) /* Set BREAK Condition */
|
|
#define UARTLCR_SETP (1 << 5) /* Set Parity to LCR[4] */
|
|
#define UARTLCR_EVEN (1 << 4) /* Even Parity Format */
|
|
#define UARTLCR_PAR (1 << 3) /* Parity */
|
|
#define UARTLCR_STOP (1 << 2) /* Stop Bit */
|
|
#define UARTLCR_WORDSZ_5 0 /* Word Length of 5 */
|
|
#define UARTLCR_WORDSZ_6 1 /* Word Length of 6 */
|
|
#define UARTLCR_WORDSZ_7 2 /* Word Length of 7 */
|
|
#define UARTLCR_WORDSZ_8 3 /* Word Length of 8 */
|
|
|
|
/* Line Status Register bits */
|
|
#define UARTLSR_RXFIFOEMT (1 << 9) /* Rx Fifo Empty */
|
|
#define UARTLSR_TXFIFOFULL (1 << 8) /* Tx Fifo Full */
|
|
#define UARTLSR_RXFIFOERR (1 << 7) /* Rx Fifo Error */
|
|
#define UARTLSR_TEMT (1 << 6) /* Tx Shift Register Empty */
|
|
#define UARTLSR_THRE (1 << 5) /* Tx Holding Register Empty */
|
|
#define UARTLSR_BRK (1 << 4) /* Break Condition Detected */
|
|
#define UARTLSR_FERR (1 << 3) /* Framing Error */
|
|
#define UARTLSR_PERR (1 << 3) /* Parity Error */
|
|
#define UARTLSR_OVRF (1 << 2) /* Rx Overrun Error */
|
|
#define UARTLSR_RDR_BIT (0) /* Rx Data Ready Bit */
|
|
#define UARTLSR_RDR (1 << UARTLSR_RDR_BIT) /* Rx Data Ready */
|
|
|
|
#define CONSOLE_T_16550_BASE CONSOLE_T_DRVDATA
|
|
|
|
#ifndef __ASSEMBLY__
|
|
|
|
#include <stdint.h>
|
|
|
|
typedef struct {
|
|
console_t console;
|
|
uintptr_t base;
|
|
} console_16550_t;
|
|
|
|
/*
|
|
* Initialize a new 16550 console instance and register it with the console
|
|
* framework. The |console| pointer must point to storage that will be valid
|
|
* for the lifetime of the console, such as a global or static local variable.
|
|
* Its contents will be reinitialized from scratch.
|
|
*/
|
|
int console_16550_register(uintptr_t baseaddr, uint32_t clock, uint32_t baud,
|
|
console_16550_t *console);
|
|
|
|
#endif /*__ASSEMBLY__*/
|
|
|
|
#endif /* UART_16550_H */
|