Move console drivers to AArch64 folder
authorSoby Mathew <soby.mathew@arm.com>
Mon, 8 Aug 2016 11:38:52 +0000 (12:38 +0100)
committerSoby Mathew <soby.mathew@arm.com>
Tue, 9 Aug 2016 16:33:57 +0000 (17:33 +0100)
This patch moves the various assembly console drivers
into `aarch64` architecture specific folder. Stub files,
which include files from new location, are retained at the
original location for platform compatibility reasons.

Change-Id: I0069b6c1c0489ca47f5204d4e26e3bc3def533a8

drivers/arm/pl011/aarch64/pl011_console.S [new file with mode: 0644]
drivers/arm/pl011/pl011_console.S
drivers/cadence/uart/aarch64/cdns_console.S [new file with mode: 0644]
drivers/cadence/uart/cdns_console.S
drivers/console/aarch64/console.S [new file with mode: 0644]
drivers/console/aarch64/skeleton_console.S [new file with mode: 0644]
drivers/console/console.S
drivers/console/skeleton_console.S
drivers/ti/uart/16550_console.S
drivers/ti/uart/aarch64/16550_console.S [new file with mode: 0644]

diff --git a/drivers/arm/pl011/aarch64/pl011_console.S b/drivers/arm/pl011/aarch64/pl011_console.S
new file mode 100644 (file)
index 0000000..11e3df7
--- /dev/null
@@ -0,0 +1,153 @@
+/*
+ * Copyright (c) 2013-2016, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 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.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * 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 HOLDER 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 <arch.h>
+#include <asm_macros.S>
+#include <pl011.h>
+
+/*
+ * Pull in generic functions to provide backwards compatibility for
+ * platform makefiles
+ */
+#include "../../../console/aarch64/console.S"
+
+
+       .globl  console_core_init
+       .globl  console_core_putc
+       .globl  console_core_getc
+
+
+       /* -----------------------------------------------
+        * int console_core_init(uintptr_t base_addr,
+        * unsigned int uart_clk, unsigned int baud_rate)
+        * Function to initialize the console without a
+        * C Runtime to print debug information. This
+        * function will be accessed by console_init and
+        * crash reporting.
+        * In: x0 - console base address
+        *     w1 - Uart clock in Hz
+        *     w2 - Baud rate
+        * Out: return 1 on success else 0 on error
+        * Clobber list : x1, x2, x3, x4
+        * -----------------------------------------------
+        */
+func console_core_init
+       /* Check the input base address */
+       cbz     x0, core_init_fail
+#if !PL011_GENERIC_UART
+       /* Check baud rate and uart clock for sanity */
+       cbz     w1, core_init_fail
+       cbz     w2, core_init_fail
+       /* Disable uart before programming */
+       ldr     w3, [x0, #UARTCR]
+       mov     w4, #PL011_UARTCR_UARTEN
+       bic     w3, w3, w4
+       str     w3, [x0, #UARTCR]
+       /* Program the baudrate */
+       /* Divisor =  (Uart clock * 4) / baudrate */
+       lsl     w1, w1, #2
+       udiv    w2, w1, w2
+       /* IBRD = Divisor >> 6 */
+       lsr     w1, w2, #6
+       /* Write the IBRD */
+       str     w1, [x0, #UARTIBRD]
+       /* FBRD = Divisor & 0x3F */
+       and     w1, w2, #0x3f
+       /* Write the FBRD */
+       str     w1, [x0, #UARTFBRD]
+       mov     w1, #PL011_LINE_CONTROL
+       str     w1, [x0, #UARTLCR_H]
+       /* Clear any pending errors */
+       str     wzr, [x0, #UARTECR]
+       /* Enable tx, rx, and uart overall */
+       mov     w1, #(PL011_UARTCR_RXE | PL011_UARTCR_TXE | PL011_UARTCR_UARTEN)
+       str     w1, [x0, #UARTCR]
+#endif
+       mov     w0, #1
+       ret
+core_init_fail:
+       mov     w0, wzr
+       ret
+endfunc console_core_init
+
+       /* --------------------------------------------------------
+        * int console_core_putc(int c, uintptr_t base_addr)
+        * Function to output a character over the console. It
+        * returns the character printed on success or -1 on error.
+        * In : w0 - character to be printed
+        *      x1 - console base address
+        * Out : return -1 on error else return character.
+        * Clobber list : x2
+        * --------------------------------------------------------
+        */
+func console_core_putc
+       /* Check the input parameter */
+       cbz     x1, putc_error
+       /* Prepend '\r' to '\n' */
+       cmp     w0, #0xA
+       b.ne    2f
+1:
+       /* Check if the transmit FIFO is full */
+       ldr     w2, [x1, #UARTFR]
+       tbnz    w2, #PL011_UARTFR_TXFF_BIT, 1b
+       mov     w2, #0xD
+       str     w2, [x1, #UARTDR]
+2:
+       /* Check if the transmit FIFO is full */
+       ldr     w2, [x1, #UARTFR]
+       tbnz    w2, #PL011_UARTFR_TXFF_BIT, 2b
+       str     w0, [x1, #UARTDR]
+       ret
+putc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_putc
+
+       /* ---------------------------------------------
+        * int console_core_getc(uintptr_t base_addr)
+        * Function to get a character from the console.
+        * It returns the character grabbed on success
+        * or -1 on error.
+        * In : x0 - console base address
+        * Clobber list : x0, x1
+        * ---------------------------------------------
+        */
+func console_core_getc
+       cbz     x0, getc_error
+1:
+       /* Check if the receive FIFO is empty */
+       ldr     w1, [x0, #UARTFR]
+       tbnz    w1, #PL011_UARTFR_RXFE_BIT, 1b
+       ldr     w1, [x0, #UARTDR]
+       mov     w0, w1
+       ret
+getc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_getc
index 5e97e9119d3635431b3d818001a08422cf4033f1..44aafc2d8ce1f72ed31c538e4c5f5e4a0e7ffbce 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2013-2015, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2013-2016, ARM Limited and Contributors. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-#include <arch.h>
-#include <asm_macros.S>
-#include <pl011.h>
 
-/*
- * Pull in generic functions to provide backwards compatibility for
- * platform makefiles
- */
-#include "../../console/console.S"
-
-
-       .globl  console_core_init
-       .globl  console_core_putc
-       .globl  console_core_getc
-
-
-       /* -----------------------------------------------
-        * int console_core_init(uintptr_t base_addr,
-        * unsigned int uart_clk, unsigned int baud_rate)
-        * Function to initialize the console without a
-        * C Runtime to print debug information. This
-        * function will be accessed by console_init and
-        * crash reporting.
-        * In: x0 - console base address
-        *     w1 - Uart clock in Hz
-        *     w2 - Baud rate
-        * Out: return 1 on success else 0 on error
-        * Clobber list : x1, x2, x3, x4
-        * -----------------------------------------------
-        */
-func console_core_init
-       /* Check the input base address */
-       cbz     x0, core_init_fail
-#if !PL011_GENERIC_UART
-       /* Check baud rate and uart clock for sanity */
-       cbz     w1, core_init_fail
-       cbz     w2, core_init_fail
-       /* Disable uart before programming */
-       ldr     w3, [x0, #UARTCR]
-       mov     w4, #PL011_UARTCR_UARTEN
-       bic     w3, w3, w4
-       str     w3, [x0, #UARTCR]
-       /* Program the baudrate */
-       /* Divisor =  (Uart clock * 4) / baudrate */
-       lsl     w1, w1, #2
-       udiv    w2, w1, w2
-       /* IBRD = Divisor >> 6 */
-       lsr     w1, w2, #6
-       /* Write the IBRD */
-       str     w1, [x0, #UARTIBRD]
-       /* FBRD = Divisor & 0x3F */
-       and     w1, w2, #0x3f
-       /* Write the FBRD */
-       str     w1, [x0, #UARTFBRD]
-       mov     w1, #PL011_LINE_CONTROL
-       str     w1, [x0, #UARTLCR_H]
-       /* Clear any pending errors */
-       str     wzr, [x0, #UARTECR]
-       /* Enable tx, rx, and uart overall */
-       mov     w1, #(PL011_UARTCR_RXE | PL011_UARTCR_TXE | PL011_UARTCR_UARTEN)
-       str     w1, [x0, #UARTCR]
+#if !ERROR_DEPRECATED
+#include "./aarch64/pl011_console.S"
 #endif
-       mov     w0, #1
-       ret
-core_init_fail:
-       mov     w0, wzr
-       ret
-endfunc console_core_init
-
-       /* --------------------------------------------------------
-        * int console_core_putc(int c, uintptr_t base_addr)
-        * Function to output a character over the console. It
-        * returns the character printed on success or -1 on error.
-        * In : w0 - character to be printed
-        *      x1 - console base address
-        * Out : return -1 on error else return character.
-        * Clobber list : x2
-        * --------------------------------------------------------
-        */
-func console_core_putc
-       /* Check the input parameter */
-       cbz     x1, putc_error
-       /* Prepend '\r' to '\n' */
-       cmp     w0, #0xA
-       b.ne    2f
-1:
-       /* Check if the transmit FIFO is full */
-       ldr     w2, [x1, #UARTFR]
-       tbnz    w2, #PL011_UARTFR_TXFF_BIT, 1b
-       mov     w2, #0xD
-       str     w2, [x1, #UARTDR]
-2:
-       /* Check if the transmit FIFO is full */
-       ldr     w2, [x1, #UARTFR]
-       tbnz    w2, #PL011_UARTFR_TXFF_BIT, 2b
-       str     w0, [x1, #UARTDR]
-       ret
-putc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_putc
-
-       /* ---------------------------------------------
-        * int console_core_getc(uintptr_t base_addr)
-        * Function to get a character from the console.
-        * It returns the character grabbed on success
-        * or -1 on error.
-        * In : x0 - console base address
-        * Clobber list : x0, x1
-        * ---------------------------------------------
-        */
-func console_core_getc
-       cbz     x0, getc_error
-1:
-       /* Check if the receive FIFO is empty */
-       ldr     w1, [x0, #UARTFR]
-       tbnz    w1, #PL011_UARTFR_RXFE_BIT, 1b
-       ldr     w1, [x0, #UARTDR]
-       mov     w0, w1
-       ret
-getc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_getc
diff --git a/drivers/cadence/uart/aarch64/cdns_console.S b/drivers/cadence/uart/aarch64/cdns_console.S
new file mode 100644 (file)
index 0000000..2c7960d
--- /dev/null
@@ -0,0 +1,127 @@
+/*
+ * Copyright (c) 2016, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 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.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * 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 HOLDER 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 <arch.h>
+#include <asm_macros.S>
+#include <cadence/cdns_uart.h>
+
+        .globl  console_core_init
+        .globl  console_core_putc
+        .globl  console_core_getc
+
+       /* -----------------------------------------------
+        * int console_core_init(unsigned long base_addr,
+        * unsigned int uart_clk, unsigned int baud_rate)
+        * Function to initialize the console without a
+        * C Runtime to print debug information. This
+        * function will be accessed by console_init and
+        * crash reporting.
+        * We assume that the bootloader already set up
+        * the HW (baud, ...) and only enable the trans-
+        * mitter and receiver here.
+        * In: x0 - console base address
+        *     w1 - Uart clock in Hz
+        *     w2 - Baud rate
+        * Out: return 1 on success else 0 on error
+        * Clobber list : x1, x2, x3
+        * -----------------------------------------------
+        */
+func console_core_init
+       /* Check the input base address */
+       cbz     x0, core_init_fail
+       /* Check baud rate and uart clock for sanity */
+       cbz     w1, core_init_fail
+       cbz     w2, core_init_fail
+
+       /* RX/TX enabled & reset */
+       mov     w3, #(R_UART_CR_TX_EN | R_UART_CR_RX_EN | R_UART_CR_TXRST | R_UART_CR_RXRST)
+       str     w3, [x0, #R_UART_CR]
+
+       mov     w0, #1
+       ret
+core_init_fail:
+       mov     w0, wzr
+       ret
+endfunc console_core_init
+
+       /* --------------------------------------------------------
+        * int console_core_putc(int c, unsigned long base_addr)
+        * Function to output a character over the console. It
+        * returns the character printed on success or -1 on error.
+        * In : w0 - character to be printed
+        *      x1 - console base address
+        * Out : return -1 on error else return character.
+        * Clobber list : x2
+        * --------------------------------------------------------
+        */
+func console_core_putc
+       /* Check the input parameter */
+       cbz     x1, putc_error
+       /* Prepend '\r' to '\n' */
+       cmp     w0, #0xA
+       b.ne    2f
+1:
+       /* Check if the transmit FIFO is full */
+       ldr     w2, [x1, #R_UART_SR]
+       tbnz    w2, #UART_SR_INTR_TFUL_BIT, 1b
+       mov     w2, #0xD
+       str     w2, [x1, #R_UART_TX]
+2:
+       /* Check if the transmit FIFO is full */
+       ldr     w2, [x1, #R_UART_SR]
+       tbnz    w2, #UART_SR_INTR_TFUL_BIT, 2b
+       str     w0, [x1, #R_UART_TX]
+       ret
+putc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_putc
+
+       /* ---------------------------------------------
+        * int console_core_getc(unsigned long base_addr)
+        * Function to get a character from the console.
+        * It returns the character grabbed on success
+        * or -1 on error.
+        * In : x0 - console base address
+        * Clobber list : x0, x1
+        * ---------------------------------------------
+        */
+func console_core_getc
+       cbz     x0, getc_error
+1:
+       /* Check if the receive FIFO is empty */
+       ldr     w1, [x0, #R_UART_SR]
+       tbnz    w1, #UART_SR_INTR_REMPTY_BIT, 1b
+       ldr     w1, [x0, #R_UART_RX]
+       mov     w0, w1
+       ret
+getc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_getc
index 2c7960d87c38232d8f59425999140883a1c3abd3..f727838762362a76564a48f8613d8bd9ef56b0d1 100644 (file)
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-#include <arch.h>
-#include <asm_macros.S>
-#include <cadence/cdns_uart.h>
 
-        .globl  console_core_init
-        .globl  console_core_putc
-        .globl  console_core_getc
-
-       /* -----------------------------------------------
-        * int console_core_init(unsigned long base_addr,
-        * unsigned int uart_clk, unsigned int baud_rate)
-        * Function to initialize the console without a
-        * C Runtime to print debug information. This
-        * function will be accessed by console_init and
-        * crash reporting.
-        * We assume that the bootloader already set up
-        * the HW (baud, ...) and only enable the trans-
-        * mitter and receiver here.
-        * In: x0 - console base address
-        *     w1 - Uart clock in Hz
-        *     w2 - Baud rate
-        * Out: return 1 on success else 0 on error
-        * Clobber list : x1, x2, x3
-        * -----------------------------------------------
-        */
-func console_core_init
-       /* Check the input base address */
-       cbz     x0, core_init_fail
-       /* Check baud rate and uart clock for sanity */
-       cbz     w1, core_init_fail
-       cbz     w2, core_init_fail
-
-       /* RX/TX enabled & reset */
-       mov     w3, #(R_UART_CR_TX_EN | R_UART_CR_RX_EN | R_UART_CR_TXRST | R_UART_CR_RXRST)
-       str     w3, [x0, #R_UART_CR]
-
-       mov     w0, #1
-       ret
-core_init_fail:
-       mov     w0, wzr
-       ret
-endfunc console_core_init
-
-       /* --------------------------------------------------------
-        * int console_core_putc(int c, unsigned long base_addr)
-        * Function to output a character over the console. It
-        * returns the character printed on success or -1 on error.
-        * In : w0 - character to be printed
-        *      x1 - console base address
-        * Out : return -1 on error else return character.
-        * Clobber list : x2
-        * --------------------------------------------------------
-        */
-func console_core_putc
-       /* Check the input parameter */
-       cbz     x1, putc_error
-       /* Prepend '\r' to '\n' */
-       cmp     w0, #0xA
-       b.ne    2f
-1:
-       /* Check if the transmit FIFO is full */
-       ldr     w2, [x1, #R_UART_SR]
-       tbnz    w2, #UART_SR_INTR_TFUL_BIT, 1b
-       mov     w2, #0xD
-       str     w2, [x1, #R_UART_TX]
-2:
-       /* Check if the transmit FIFO is full */
-       ldr     w2, [x1, #R_UART_SR]
-       tbnz    w2, #UART_SR_INTR_TFUL_BIT, 2b
-       str     w0, [x1, #R_UART_TX]
-       ret
-putc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_putc
-
-       /* ---------------------------------------------
-        * int console_core_getc(unsigned long base_addr)
-        * Function to get a character from the console.
-        * It returns the character grabbed on success
-        * or -1 on error.
-        * In : x0 - console base address
-        * Clobber list : x0, x1
-        * ---------------------------------------------
-        */
-func console_core_getc
-       cbz     x0, getc_error
-1:
-       /* Check if the receive FIFO is empty */
-       ldr     w1, [x0, #R_UART_SR]
-       tbnz    w1, #UART_SR_INTR_REMPTY_BIT, 1b
-       ldr     w1, [x0, #R_UART_RX]
-       mov     w0, w1
-       ret
-getc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_getc
+#if !ERROR_DEPRECATED
+#include "./aarch64/cdns_console.S"
+#endif
diff --git a/drivers/console/aarch64/console.S b/drivers/console/aarch64/console.S
new file mode 100644 (file)
index 0000000..bdd5f4c
--- /dev/null
@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 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.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * 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 HOLDER 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 <asm_macros.S>
+
+       .globl  console_init
+       .globl  console_uninit
+       .globl  console_putc
+       .globl  console_getc
+
+       /*
+        *  The console base is in the data section and not in .bss
+        *  even though it is zero-init. In particular, this allows
+        *  the console functions to start using this variable before
+        *  the runtime memory is initialized for images which do not
+        *  need to copy the .data section from ROM to RAM.
+        */
+.section .data.console_base ; .align 3
+       console_base: .quad 0x0
+
+       /* -----------------------------------------------
+        * int console_init(uintptr_t base_addr,
+        * unsigned int uart_clk, unsigned int baud_rate)
+        * Function to initialize the console without a
+        * C Runtime to print debug information. It saves
+        * the console base to the data section.
+        * In: x0 - console base address
+        *     w1 - Uart clock in Hz
+        *     w2 - Baud rate
+        * out: return 1 on success else 0 on error
+        * Clobber list : x1 - x4
+        * -----------------------------------------------
+        */
+func console_init
+       /* Check the input base address */
+       cbz     x0, init_fail
+       adrp    x3, console_base
+       str     x0, [x3, :lo12:console_base]
+       b       console_core_init
+init_fail:
+       ret
+endfunc console_init
+
+       /* -----------------------------------------------
+        * void console_uninit(void)
+        * Function to finish the use of console driver.
+        * It sets the console_base as NULL so that any
+        * further invocation of `console_putc` or
+        * `console_getc` APIs would return error.
+        * -----------------------------------------------
+        */
+func console_uninit
+       mov     x0, #0
+       adrp    x3, console_base
+       str     x0, [x3, :lo12:console_base]
+       ret
+endfunc console_uninit
+
+       /* ---------------------------------------------
+        * int console_putc(int c)
+        * Function to output a character over the
+        * console. It returns the character printed on
+        * success or -1 on error.
+        * In : x0 - character to be printed
+        * Out : return -1 on error else return character.
+        * Clobber list : x1, x2
+        * ---------------------------------------------
+        */
+func console_putc
+       adrp    x2, console_base
+       ldr     x1, [x2, :lo12:console_base]
+       b       console_core_putc
+endfunc console_putc
+
+       /* ---------------------------------------------
+        * int console_getc(void)
+        * Function to get a character from the console.
+        * It returns the character grabbed on success
+        * or -1 on error.
+        * Clobber list : x0, x1
+        * ---------------------------------------------
+        */
+func console_getc
+       adrp    x1, console_base
+       ldr     x0, [x1, :lo12:console_base]
+       b       console_core_getc
+endfunc console_getc
diff --git a/drivers/console/aarch64/skeleton_console.S b/drivers/console/aarch64/skeleton_console.S
new file mode 100644 (file)
index 0000000..1583ee7
--- /dev/null
@@ -0,0 +1,106 @@
+/*
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 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.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * 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 HOLDER 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 <asm_macros.S>
+
+       /*
+        * This file contains a skeleton console implementation that can
+        * be used as basis for a real console implementation by platforms
+        * that do not contain PL011 hardware.
+        */
+
+       .globl  console_core_init
+       .globl  console_core_putc
+       .globl  console_core_getc
+
+       /* -----------------------------------------------
+        * int console_core_init(uintptr_t base_addr,
+        * unsigned int uart_clk, unsigned int baud_rate)
+        * Function to initialize the console without a
+        * C Runtime to print debug information. This
+        * function will be accessed by console_init and
+        * crash reporting.
+        * In: x0 - console base address
+        *     w1 - Uart clock in Hz
+        *     w2 - Baud rate
+        * Out: return 1 on success else 0 on error
+        * Clobber list : x1, x2
+        * -----------------------------------------------
+        */
+func console_core_init
+       /* Check the input base address */
+       cbz     x0, core_init_fail
+       /* Check baud rate and uart clock for sanity */
+       cbz     w1, core_init_fail
+       cbz     w2, core_init_fail
+       /* Insert implementation here */
+       mov     w0, #1
+       ret
+core_init_fail:
+       mov     w0, wzr
+       ret
+endfunc console_core_init
+
+       /* --------------------------------------------------------
+        * int console_core_putc(int c, uintptr_t base_addr)
+        * Function to output a character over the console. It
+        * returns the character printed on success or -1 on error.
+        * In : w0 - character to be printed
+        *      x1 - console base address
+        * Out : return -1 on error else return character.
+        * Clobber list : x2
+        * --------------------------------------------------------
+        */
+func console_core_putc
+       /* Check the input parameter */
+       cbz     x1, putc_error
+       /* Insert implementation here */
+       ret
+putc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_putc
+
+       /* ---------------------------------------------
+        * int console_core_getc(uintptr_t base_addr)
+        * Function to get a character from the console.
+        * It returns the character grabbed on success
+        * or -1 on error.
+        * In : x0 - console base address
+        * Clobber list : x0, x1
+        * ---------------------------------------------
+        */
+func console_core_getc
+       cbz     x0, getc_error
+       /* Insert implementation here */
+       ret
+getc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_getc
index 797b56450d18a7f21c73110e11032f734c68b147..e8612985ec1355c673e286f13e26ae7c86b9f8dd 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-#include <asm_macros.S>
 
-       .globl  console_init
-       .globl  console_uninit
-       .globl  console_putc
-       .globl  console_getc
-
-       /*
-        *  The console base is in the data section and not in .bss
-        *  even though it is zero-init. In particular, this allows
-        *  the console functions to start using this variable before
-        *  the runtime memory is initialized for images which do not
-        *  need to copy the .data section from ROM to RAM.
-        */
-.section .data.console_base ; .align 3
-       console_base: .quad 0x0
-
-       /* -----------------------------------------------
-        * int console_init(uintptr_t base_addr,
-        * unsigned int uart_clk, unsigned int baud_rate)
-        * Function to initialize the console without a
-        * C Runtime to print debug information. It saves
-        * the console base to the data section.
-        * In: x0 - console base address
-        *     w1 - Uart clock in Hz
-        *     w2 - Baud rate
-        * out: return 1 on success else 0 on error
-        * Clobber list : x1 - x4
-        * -----------------------------------------------
-        */
-func console_init
-       /* Check the input base address */
-       cbz     x0, init_fail
-       adrp    x3, console_base
-       str     x0, [x3, :lo12:console_base]
-       b       console_core_init
-init_fail:
-       ret
-endfunc console_init
-
-       /* -----------------------------------------------
-        * void console_uninit(void)
-        * Function to finish the use of console driver.
-        * It sets the console_base as NULL so that any
-        * further invocation of `console_putc` or
-        * `console_getc` APIs would return error.
-        * -----------------------------------------------
-        */
-func console_uninit
-       mov     x0, #0
-       adrp    x3, console_base
-       str     x0, [x3, :lo12:console_base]
-       ret
-endfunc console_uninit
-
-       /* ---------------------------------------------
-        * int console_putc(int c)
-        * Function to output a character over the
-        * console. It returns the character printed on
-        * success or -1 on error.
-        * In : x0 - character to be printed
-        * Out : return -1 on error else return character.
-        * Clobber list : x1, x2
-        * ---------------------------------------------
-        */
-func console_putc
-       adrp    x2, console_base
-       ldr     x1, [x2, :lo12:console_base]
-       b       console_core_putc
-endfunc console_putc
-
-       /* ---------------------------------------------
-        * int console_getc(void)
-        * Function to get a character from the console.
-        * It returns the character grabbed on success
-        * or -1 on error.
-        * Clobber list : x0, x1
-        * ---------------------------------------------
-        */
-func console_getc
-       adrp    x1, console_base
-       ldr     x0, [x1, :lo12:console_base]
-       b       console_core_getc
-endfunc console_getc
+#if !ERROR_DEPRECATED
+#include "./aarch64/console.S"
+#endif
index 083d3c70cd3bbc51e3486acebbf9f91ca01dd60b..ddfd83483d15a911c96f10a7aa8e6e88b3a16b21 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */
-#include <asm_macros.S>
 
-       /*
-        * This file contains a skeleton console implementation that can
-        * be used as basis for a real console implementation by platforms
-        * that do not contain PL011 hardware.
-        */
-
-       .globl  console_core_init
-       .globl  console_core_putc
-       .globl  console_core_getc
-
-       /* -----------------------------------------------
-        * int console_core_init(uintptr_t base_addr,
-        * unsigned int uart_clk, unsigned int baud_rate)
-        * Function to initialize the console without a
-        * C Runtime to print debug information. This
-        * function will be accessed by console_init and
-        * crash reporting.
-        * In: x0 - console base address
-        *     w1 - Uart clock in Hz
-        *     w2 - Baud rate
-        * Out: return 1 on success else 0 on error
-        * Clobber list : x1, x2
-        * -----------------------------------------------
-        */
-func console_core_init
-       /* Check the input base address */
-       cbz     x0, core_init_fail
-       /* Check baud rate and uart clock for sanity */
-       cbz     w1, core_init_fail
-       cbz     w2, core_init_fail
-       /* Insert implementation here */
-       mov     w0, #1
-       ret
-core_init_fail:
-       mov     w0, wzr
-       ret
-endfunc console_core_init
-
-       /* --------------------------------------------------------
-        * int console_core_putc(int c, uintptr_t base_addr)
-        * Function to output a character over the console. It
-        * returns the character printed on success or -1 on error.
-        * In : w0 - character to be printed
-        *      x1 - console base address
-        * Out : return -1 on error else return character.
-        * Clobber list : x2
-        * --------------------------------------------------------
-        */
-func console_core_putc
-       /* Check the input parameter */
-       cbz     x1, putc_error
-       /* Insert implementation here */
-       ret
-putc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_putc
-
-       /* ---------------------------------------------
-        * int console_core_getc(uintptr_t base_addr)
-        * Function to get a character from the console.
-        * It returns the character grabbed on success
-        * or -1 on error.
-        * In : x0 - console base address
-        * Clobber list : x0, x1
-        * ---------------------------------------------
-        */
-func console_core_getc
-       cbz     x0, getc_error
-       /* Insert implementation here */
-       ret
-getc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_getc
+#if !ERROR_DEPRECATED
+#include "./aarch64/skeleton_console.S"
+#endif
index ebb461514cf948f6a9260c112ce3487d691041ab..90b12e5f91c8fdf8577d1b0178d667f1cd0654b1 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  * POSSIBILITY OF SUCH DAMAGE.
  */
 
-#include <arch.h>
-#include <asm_macros.S>
-#include <uart_16550.h>
-
-       .globl  console_core_init
-       .globl  console_core_putc
-       .globl  console_core_getc
-
-       /* -----------------------------------------------
-        * int console_core_init(unsigned long base_addr,
-        * unsigned int uart_clk, unsigned int baud_rate)
-        * Function to initialize the console without a
-        * C Runtime to print debug information. This
-        * function will be accessed by console_init and
-        * crash reporting.
-        * In: x0 - console base address
-        *     w1 - Uart clock in Hz
-        *     w2 - Baud rate
-        * Out: return 1 on success
-        * Clobber list : x1, x2, x3
-        * -----------------------------------------------
-        */
-func console_core_init
-       /* Check the input base address */
-       cbz     x0, init_fail
-       /* Check baud rate and uart clock for sanity */
-       cbz     w1, init_fail
-       cbz     w2, init_fail
-
-       /* Program the baudrate */
-       /* Divisor =  Uart clock / (16 * baudrate) */
-       lsl     w2, w2, #4
-       udiv    w2, w1, w2
-       and     w1, w2, #0xff           /* w1 = DLL */
-       lsr     w2, w2, #8
-       and     w2, w2, #0xff           /* w2 = DLLM */
-       ldr     w3, [x0, #UARTLCR]
-       orr     w3, w3, #UARTLCR_DLAB
-       str     w3, [x0, #UARTLCR]      /* enable DLL, DLLM programming */
-       str     w1, [x0, #UARTDLL]      /* program DLL */
-       str     w2, [x0, #UARTDLLM]     /* program DLLM */
-       mov     w2, #~UARTLCR_DLAB
-       and     w3, w3, w2
-       str     w3, [x0, #UARTLCR]      /* disable DLL, DLLM programming */
-
-       /* 8n1 */
-       mov     w3, #3
-       str     w3, [x0, #UARTLCR]
-       /* no interrupt */
-       mov     w3, #0
-       str     w3, [x0, #UARTIER]
-       /* enable fifo, DMA */
-       mov     w3, #(UARTFCR_FIFOEN | UARTFCR_DMAEN)
-       str     w3, [x0, #UARTFCR]
-       /* DTR + RTS */
-       mov     w3, #3
-       str     w3, [x0, #UARTMCR]
-       mov     w0, #1
-init_fail:
-       ret
-endfunc console_core_init
-
-       /* --------------------------------------------------------
-        * int console_core_putc(int c, unsigned int base_addr)
-        * Function to output a character over the console. It
-        * returns the character printed on success or -1 on error.
-        * In : w0 - character to be printed
-        *      x1 - console base address
-        * Out : return -1 on error else return character.
-        * Clobber list : x2
-        * --------------------------------------------------------
-        */
-func console_core_putc
-       /* Check the input parameter */
-       cbz     x1, putc_error
-
-       /* Prepend '\r' to '\n' */
-       cmp     w0, #0xA
-       b.ne    2f
-       /* Check if the transmit FIFO is full */
-1:     ldr     w2, [x1, #UARTLSR]
-       and     w2, w2, #(UARTLSR_TEMT | UARTLSR_THRE)
-       cmp     w2, #(UARTLSR_TEMT | UARTLSR_THRE)
-       b.ne    1b
-       mov     w2, #0xD                /* '\r' */
-       str     w2, [x1, #UARTTX]
-       ldr     w2, [x1, #UARTFCR]
-       orr     w2, w2, #UARTFCR_TXCLR
-       str     w2, [x1, #UARTFCR]
-
-       /* Check if the transmit FIFO is full */
-2:     ldr     w2, [x1, #UARTLSR]
-       and     w2, w2, #(UARTLSR_TEMT | UARTLSR_THRE)
-       cmp     w2, #(UARTLSR_TEMT | UARTLSR_THRE)
-       b.ne    2b
-       str     w0, [x1, #UARTTX]
-       ldr     w2, [x1, #UARTFCR]
-       orr     w2, w2, #UARTFCR_TXCLR
-       str     w2, [x1, #UARTFCR]
-       ret
-putc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_putc
-
-       /* ---------------------------------------------
-        * int console_core_getc(void)
-        * Function to get a character from the console.
-        * It returns the character grabbed on success
-        * or -1 on error.
-        * In : w0 - console base address
-        * Out : return -1 on error else return character.
-        * Clobber list : x0, x1
-        * ---------------------------------------------
-        */
-func console_core_getc
-       /* Check if the receive FIFO is empty */
-1:     ldr     w1, [x0, #UARTLSR]
-       tbz     w1, #UARTLSR_RDR, 1b
-       ldr     w0, [x0, #UARTRX]
-       ret
-getc_error:
-       mov     w0, #-1
-       ret
-endfunc console_core_getc
+#if !ERROR_DEPRECATED
+#include "./aarch64/16550_console.S"
+#endif
diff --git a/drivers/ti/uart/aarch64/16550_console.S b/drivers/ti/uart/aarch64/16550_console.S
new file mode 100644 (file)
index 0000000..0535381
--- /dev/null
@@ -0,0 +1,155 @@
+/*
+ * Copyright (c) 2015-2016, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 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.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * 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 HOLDER 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 <arch.h>
+#include <asm_macros.S>
+#include <uart_16550.h>
+
+       .globl  console_core_init
+       .globl  console_core_putc
+       .globl  console_core_getc
+
+       /* -----------------------------------------------
+        * int console_core_init(unsigned long base_addr,
+        * unsigned int uart_clk, unsigned int baud_rate)
+        * Function to initialize the console without a
+        * C Runtime to print debug information. This
+        * function will be accessed by console_init and
+        * crash reporting.
+        * In: x0 - console base address
+        *     w1 - Uart clock in Hz
+        *     w2 - Baud rate
+        * Out: return 1 on success
+        * Clobber list : x1, x2, x3
+        * -----------------------------------------------
+        */
+func console_core_init
+       /* Check the input base address */
+       cbz     x0, init_fail
+       /* Check baud rate and uart clock for sanity */
+       cbz     w1, init_fail
+       cbz     w2, init_fail
+
+       /* Program the baudrate */
+       /* Divisor =  Uart clock / (16 * baudrate) */
+       lsl     w2, w2, #4
+       udiv    w2, w1, w2
+       and     w1, w2, #0xff           /* w1 = DLL */
+       lsr     w2, w2, #8
+       and     w2, w2, #0xff           /* w2 = DLLM */
+       ldr     w3, [x0, #UARTLCR]
+       orr     w3, w3, #UARTLCR_DLAB
+       str     w3, [x0, #UARTLCR]      /* enable DLL, DLLM programming */
+       str     w1, [x0, #UARTDLL]      /* program DLL */
+       str     w2, [x0, #UARTDLLM]     /* program DLLM */
+       mov     w2, #~UARTLCR_DLAB
+       and     w3, w3, w2
+       str     w3, [x0, #UARTLCR]      /* disable DLL, DLLM programming */
+
+       /* 8n1 */
+       mov     w3, #3
+       str     w3, [x0, #UARTLCR]
+       /* no interrupt */
+       mov     w3, #0
+       str     w3, [x0, #UARTIER]
+       /* enable fifo, DMA */
+       mov     w3, #(UARTFCR_FIFOEN | UARTFCR_DMAEN)
+       str     w3, [x0, #UARTFCR]
+       /* DTR + RTS */
+       mov     w3, #3
+       str     w3, [x0, #UARTMCR]
+       mov     w0, #1
+init_fail:
+       ret
+endfunc console_core_init
+
+       /* --------------------------------------------------------
+        * int console_core_putc(int c, unsigned int base_addr)
+        * Function to output a character over the console. It
+        * returns the character printed on success or -1 on error.
+        * In : w0 - character to be printed
+        *      x1 - console base address
+        * Out : return -1 on error else return character.
+        * Clobber list : x2
+        * --------------------------------------------------------
+        */
+func console_core_putc
+       /* Check the input parameter */
+       cbz     x1, putc_error
+
+       /* Prepend '\r' to '\n' */
+       cmp     w0, #0xA
+       b.ne    2f
+       /* Check if the transmit FIFO is full */
+1:     ldr     w2, [x1, #UARTLSR]
+       and     w2, w2, #(UARTLSR_TEMT | UARTLSR_THRE)
+       cmp     w2, #(UARTLSR_TEMT | UARTLSR_THRE)
+       b.ne    1b
+       mov     w2, #0xD                /* '\r' */
+       str     w2, [x1, #UARTTX]
+       ldr     w2, [x1, #UARTFCR]
+       orr     w2, w2, #UARTFCR_TXCLR
+       str     w2, [x1, #UARTFCR]
+
+       /* Check if the transmit FIFO is full */
+2:     ldr     w2, [x1, #UARTLSR]
+       and     w2, w2, #(UARTLSR_TEMT | UARTLSR_THRE)
+       cmp     w2, #(UARTLSR_TEMT | UARTLSR_THRE)
+       b.ne    2b
+       str     w0, [x1, #UARTTX]
+       ldr     w2, [x1, #UARTFCR]
+       orr     w2, w2, #UARTFCR_TXCLR
+       str     w2, [x1, #UARTFCR]
+       ret
+putc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_putc
+
+       /* ---------------------------------------------
+        * int console_core_getc(void)
+        * Function to get a character from the console.
+        * It returns the character grabbed on success
+        * or -1 on error.
+        * In : w0 - console base address
+        * Out : return -1 on error else return character.
+        * Clobber list : x0, x1
+        * ---------------------------------------------
+        */
+func console_core_getc
+       /* Check if the receive FIFO is empty */
+1:     ldr     w1, [x0, #UARTLSR]
+       tbz     w1, #UARTLSR_RDR, 1b
+       ldr     w0, [x0, #UARTRX]
+       ret
+getc_error:
+       mov     w0, #-1
+       ret
+endfunc console_core_getc