blob: 4d1c58075cf0de33ed126582fe1d2d876353e8b4 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001/* SPDX-License-Identifier: GPL-2.0+ */
Simon Glass2f964aa2015-01-26 18:27:07 -07002/*
3 * Early debug UART support
4 *
5 * (C) Copyright 2014 Google, Inc
6 * Writte by Simon Glass <sjg@chromium.org>
Simon Glass2f964aa2015-01-26 18:27:07 -07007 */
8
9#ifndef _DEBUG_UART_H
10#define _DEBUG_UART_H
11
Simon Glass2f964aa2015-01-26 18:27:07 -070012/*
13 * The debug UART is intended for use very early in U-Boot to debug problems
14 * when an ICE or other debug mechanism is not available.
15 *
16 * To use it you should:
17 * - Make sure your UART supports this interface
18 * - Enable CONFIG_DEBUG_UART
19 * - Enable the CONFIG for your UART to tell it to provide this interface
20 * (e.g. CONFIG_DEBUG_UART_NS16550)
21 * - Define the required settings as needed (see below)
22 * - Call debug_uart_init() before use
23 * - Call printch() to output a character
24 *
25 * Depending on your platform it may be possible to use this UART before a
26 * stack is available.
27 *
28 * If your UART does not support this interface you can probably add support
29 * quite easily. Remember that you cannot use driver model and it is preferred
30 * to use no stack.
31 *
32 * You must not use this UART once driver model is working and the serial
33 * drivers are up and running (done in serial_init()). Otherwise the drivers
34 * may conflict and you will get strange output.
35 *
36 *
37 * To enable the debug UART in your serial driver:
38 *
39 * - #include <debug_uart.h>
Simon Glass97b05972015-10-18 19:51:23 -060040 * - Define _debug_uart_init(), trying to avoid using the stack
Simon Glass2f964aa2015-01-26 18:27:07 -070041 * - Define _debug_uart_putc() as static inline (avoiding stack usage)
42 * - Immediately afterwards, add DEBUG_UART_FUNCS to define the rest of the
43 * functionality (printch(), etc.)
Simon Glass0e977bc2015-10-18 19:51:24 -060044 *
45 * If your board needs additional init for the UART to work, enable
46 * CONFIG_DEBUG_UART_BOARD_INIT and write a function called
47 * board_debug_uart_init() to perform that init. When debug_uart_init() is
48 * called, the init will happen automatically.
Simon Glass2f964aa2015-01-26 18:27:07 -070049 */
50
51/**
52 * debug_uart_init() - Set up the debug UART ready for use
53 *
54 * This sets up the UART with the correct baud rate, etc.
55 *
56 * Available CONFIG is:
57 *
58 * - CONFIG_DEBUG_UART_BASE: Base address of UART
59 * - CONFIG_BAUDRATE: Requested baud rate
60 * - CONFIG_DEBUG_UART_CLOCK: Input clock for UART
61 */
62void debug_uart_init(void);
63
Simon Glass0e977bc2015-10-18 19:51:24 -060064#ifdef CONFIG_DEBUG_UART_BOARD_INIT
65void board_debug_uart_init(void);
66#else
67static inline void board_debug_uart_init(void)
68{
69}
70#endif
71
Simon Glass2f964aa2015-01-26 18:27:07 -070072/**
73 * printch() - Output a character to the debug UART
74 *
75 * @ch: Character to output
76 */
Simon Glassd0d73612015-06-23 15:38:32 -060077void printch(int ch);
Simon Glass2f964aa2015-01-26 18:27:07 -070078
79/**
80 * printascii() - Output an ASCII string to the debug UART
81 *
82 * @str: String to output
83 */
Simon Glassd0d73612015-06-23 15:38:32 -060084void printascii(const char *str);
Simon Glass2f964aa2015-01-26 18:27:07 -070085
86/**
87 * printhex2() - Output a 2-digit hex value
88 *
89 * @value: Value to output
90 */
Masahiro Yamada77c4ba52020-02-25 02:24:54 +090091void printhex2(unsigned int value);
Simon Glass2f964aa2015-01-26 18:27:07 -070092
93/**
94 * printhex4() - Output a 4-digit hex value
95 *
96 * @value: Value to output
97 */
Masahiro Yamada77c4ba52020-02-25 02:24:54 +090098void printhex4(unsigned int value);
Simon Glass2f964aa2015-01-26 18:27:07 -070099
100/**
101 * printhex8() - Output a 8-digit hex value
102 *
103 * @value: Value to output
104 */
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900105void printhex8(unsigned int value);
Simon Glass2f964aa2015-01-26 18:27:07 -0700106
Jagan Teki3940ab62019-07-15 23:58:47 +0530107/**
108 * printdec() - Output a decimalism value
109 *
110 * @value: Value to output
111 */
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900112void printdec(unsigned int value);
Jagan Teki3940ab62019-07-15 23:58:47 +0530113
Simon Glassc7fefcb2015-10-18 19:51:25 -0600114#ifdef CONFIG_DEBUG_UART_ANNOUNCE
115#define _DEBUG_UART_ANNOUNCE printascii("<debug_uart> ");
116#else
117#define _DEBUG_UART_ANNOUNCE
118#endif
119
Lokesh Vutlaa52cf082017-04-22 15:57:25 +0530120#define serial_dout(reg, value) \
121 serial_out_shift((char *)com_port + \
122 ((char *)reg - (char *)com_port) * \
123 (1 << CONFIG_DEBUG_UART_SHIFT), \
124 CONFIG_DEBUG_UART_SHIFT, value)
125#define serial_din(reg) \
126 serial_in_shift((char *)com_port + \
127 ((char *)reg - (char *)com_port) * \
128 (1 << CONFIG_DEBUG_UART_SHIFT), \
129 CONFIG_DEBUG_UART_SHIFT)
130
Simon Glass2f964aa2015-01-26 18:27:07 -0700131/*
132 * Now define some functions - this should be inserted into the serial driver
133 */
134#define DEBUG_UART_FUNCS \
tim.chick6bacc732017-04-06 16:32:41 +0100135\
136 static inline void _printch(int ch) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700137 { \
Masahiro Yamadab391d742016-03-08 18:19:10 +0900138 if (ch == '\n') \
139 _debug_uart_putc('\r'); \
Simon Glass2f964aa2015-01-26 18:27:07 -0700140 _debug_uart_putc(ch); \
141 } \
142\
tim.chick6bacc732017-04-06 16:32:41 +0100143 void printch(int ch) \
144 { \
145 _printch(ch); \
146 } \
147\
Simon Glassd0d73612015-06-23 15:38:32 -0600148 void printascii(const char *str) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700149 { \
150 while (*str) \
tim.chick6bacc732017-04-06 16:32:41 +0100151 _printch(*str++); \
Simon Glass2f964aa2015-01-26 18:27:07 -0700152 } \
153\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900154 static inline void printhex1(unsigned int digit) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700155 { \
156 digit &= 0xf; \
157 _debug_uart_putc(digit > 9 ? digit - 10 + 'a' : digit + '0'); \
158 } \
159\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900160 static inline void printhex(unsigned int value, int digits) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700161 { \
162 while (digits-- > 0) \
163 printhex1(value >> (4 * digits)); \
164 } \
165\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900166 void printhex2(unsigned int value) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700167 { \
168 printhex(value, 2); \
169 } \
170\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900171 void printhex4(unsigned int value) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700172 { \
173 printhex(value, 4); \
174 } \
175\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900176 void printhex8(unsigned int value) \
Simon Glass2f964aa2015-01-26 18:27:07 -0700177 { \
178 printhex(value, 8); \
Simon Glass97b05972015-10-18 19:51:23 -0600179 } \
180\
Masahiro Yamada77c4ba52020-02-25 02:24:54 +0900181 void printdec(unsigned int value) \
Jagan Teki3940ab62019-07-15 23:58:47 +0530182 { \
183 if (value > 10) { \
184 printdec(value / 10); \
185 value %= 10; \
186 } else if (value == 10) { \
187 _debug_uart_putc('1'); \
188 value = 0; \
189 } \
190 _debug_uart_putc('0' + value); \
191 } \
192\
Simon Glass97b05972015-10-18 19:51:23 -0600193 void debug_uart_init(void) \
194 { \
Simon Glass0e977bc2015-10-18 19:51:24 -0600195 board_debug_uart_init(); \
Simon Glass97b05972015-10-18 19:51:23 -0600196 _debug_uart_init(); \
Simon Glassc7fefcb2015-10-18 19:51:25 -0600197 _DEBUG_UART_ANNOUNCE \
Simon Glass97b05972015-10-18 19:51:23 -0600198 } \
Simon Glass2f964aa2015-01-26 18:27:07 -0700199
200#endif